servant/servant-http-streams
2022-03-21 15:44:10 +01:00
..
src/Servant Derive HasClient good response status from Verb status (#1469) 2021-12-09 10:09:18 +01:00
test unsupporting GHC < 8.6.5, removing unecessary imports 2021-10-02 13:13:24 +02:00
CHANGELOG.md Changelog tweaks + servant-http-streams / servant-docs bump 2022-02-01 12:29:31 +01:00
LICENSE Add servant-http-streams 2019-02-06 12:15:30 +02:00
README.lhs Add servant-http-streams 2019-02-06 12:15:30 +02:00
README.md Add servant-http-streams 2019-02-06 12:15:30 +02:00
servant-http-streams.cabal Allow hspec-2.9 2022-03-21 15:44:10 +01:00
Setup.hs Add servant-http-streams 2019-02-06 12:15:30 +02:00

servant-client

servant

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 Servant.API
import Servant.HttpStreams


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

-- the IOException happens already in withClientEnvIO
main' :: IO ()
main' = do
    let burl = BaseUrl Http "localhost" 8081 ""
    withClientEnvIO burl $ \env -> do
        res <- runClientM getAllBooks env
        case res of
            Left err -> putStrLn $ "Error: " ++ show err
            Right books -> print books

main :: IO ()
main = return ()