Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/winterland1989/apiary-http-client

A http client for Apiary's ActionT monad stack.
https://github.com/winterland1989/apiary-http-client

Last synced: 9 days ago
JSON representation

A http client for Apiary's ActionT monad stack.

Awesome Lists containing this project

README

        

Apiary HTTP Client
==================

[![Hackage](https://img.shields.io/hackage/v/apiary-http-client.svg?style=flat)](http://hackage.haskell.org/package/apiary-http-client)
[![Travis-CI](https://travis-ci.org/winterland1989/apiary-http-client.svg)](https://travis-ci.org/winterland1989/apiary-http-client)

A HTTP Client for [Apiary](http://hackage.haskell.org/package/apiary), using `Apiary`'s extension api, suitable for proxying HTTP request to backend API, with flexible APIs and streamming proxying abilities.

This module also reexport `Network.HTTP.Client`.

Example
-------

```haskell
import Web.Apiary
import Network.Wai.Handler.Warp
import Web.Apiary.HTTP.Client as HTTP

main :: IO ()
main = runApiaryWith (run 8080) (HTTP.initHTTPClient HTTP.defaultManagerSettings) def $ do

[capture|/query|] . action $ do

-- make a new Network.HTTP.Client.Request from current ActionT's Network.Wai.Request
-- it's recommended to use resetHeaders to remove following headers:
-- Transfer-Encoding, Content-Length, Content-Encoding and Accept-Encoding.
req <- HTTP.fromRequest id resetHeaders

-- set proxying host and port
-- use function from Network.HTTP.Client to modify more
let req' = HTTP.setHost "api.backend.com" . HTTP.setPort 80 $ req

-- send request and proxy respond in streamming fashion.
HTTP.proxyTo req'
```