servant-client
automatical derivation of querying functions for servant webservices
http://haskell-servant.readthedocs.org/
| Version on this page: | 0.14@rev:3 |
| LTS Haskell 20.25: | 0.19@rev:5 |
| Stackage Nightly 2023-06-10: | 0.19@rev:5 |
| Latest on Hackage: | 0.19@rev:5 |
Maintained by haskell-servant-maintainers@googlegroups.com
This version can be pinned in stack with:
servant-client-0.14@sha256:0f59f49bd11e0eee2a8ef6a3366c51a9c95b9ea5d1a34811962b14e77dc752e6,4235Module documentation for 0.14
- Servant
- Servant.Client
- Servant.Client.Internal
- Servant.Client
Depends on 18 packages(full list with versions):
Used by 7 packages in lts-12.26(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