servant/servant-client/README.md

# servant-client

![servant](https://raw.githubusercontent.com/haskell-servant/servant/master/servant.png)

This library lets you automatically derive Haskell functions that let you query each endpoint of a *servant* webservice.

## Example

``` haskell
type MyApi = "books" :> Get '[JSON] [Book] -- GET /books
        :<|> "books" :> ReqBody Book :> Post '[JSON] Book -- POST /books

myApi :: Proxy MyApi
myApi = Proxy

getAllBooks :: Manager -> BaseUrl -> ExceptT String IO [Book]
postNewBook :: Book -> Manager -> BaseUrl -> ExceptT String IO Book
-- 'client' allows you to produce operations to query an API from a client.
(getAllBooks :<|> postNewBook) = client myApi
```
polish up cabal file, add a README 2014-12-08 11:10:51 +01:00			`# servant-client`

			`![servant](https://raw.githubusercontent.com/haskell-servant/servant/master/servant.png)`

Cleanup. 2015-02-06 09:34:59 +01:00			`This library lets you automatically derive Haskell functions that let you query each endpoint of a servant webservice.`
polish up cabal file, add a README 2014-12-08 11:10:51 +01:00
			`## Example`

			``` haskell
update examples in servant-client. fixes #75 2015-05-14 00:52:37 +02:00			`type MyApi = "books" :> Get '[JSON] [Book] -- GET /books`
			`:<\|> "books" :> ReqBody Book :> Post '[JSON] Book -- POST /books`
polish up cabal file, add a README 2014-12-08 11:10:51 +01:00
			`myApi :: Proxy MyApi`
			`myApi = Proxy`

Merge branch 'master' of https://github.com/haskell-servant/servant into servant-dates # Conflicts: # servant-server/servant-server.cabal # servant-server/src/Servant/Server/Internal.hs # servant-server/test/Servant/ServerSpec.hs # servant/servant.cabal # servant/src/Servant/API.hs 2016-09-02 04:53:04 +02:00			`getAllBooks :: Manager -> BaseUrl -> ExceptT String IO [Book]`
			`postNewBook :: Book -> Manager -> BaseUrl -> ExceptT String IO Book`
polish up cabal file, add a README 2014-12-08 11:10:51 +01:00			`-- 'client' allows you to produce operations to query an API from a client.`
Merge branch 'master' of https://github.com/haskell-servant/servant into servant-dates # Conflicts: # servant-server/servant-server.cabal # servant-server/src/Servant/Server/Internal.hs # servant-server/test/Servant/ServerSpec.hs # servant/servant.cabal # servant/src/Servant/API.hs 2016-09-02 04:53:04 +02:00			`(getAllBooks :<\|> postNewBook) = client myApi`
Update READMEs 2015-04-20 15:38:26 +02:00			```