servant/servant-client
Ian Shipman 9666f1956b Addresses problems with URL encodings
This changes the way URL encoding for query parameters is handled,
making it possible to correctly encode arbitrary binary data into query
parameter values.

Closes #1418
2021-10-03 09:57:55 -05:00
..
src/Servant Addresses problems with URL encodings 2021-10-03 09:57:55 -05:00
test Addresses problems with URL encodings 2021-10-03 09:57:55 -05:00
CHANGELOG.md Prepare 0.18.3 release (#1430) 2021-06-24 00:38:46 +03:00
docs.sh prepare merge 2015-04-20 11:15:58 +02:00
LICENSE Changelog and cabal file edits 2018-11-13 09:58:42 +02:00
README.lhs servant-client: update README.md and test it 2018-04-18 14:18:41 +01:00
README.md servant-client: update README.md and test it 2018-04-18 14:18:41 +01:00
servant-client.cabal remove tested-with (GHC < 8.6.5) from cabal 2021-10-02 13:13:33 +02:00
Setup.hs stylish haskell changes 2015-08-18 00:07:12 +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 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