wreq

An easy-to-use HTTP client library.

http://www.serpentine.com/wreq

Version on this page:0.5.0.1
LTS Haskell 23.26:0.5.4.3
Stackage Nightly 2025-06-29:0.5.4.3
Latest on Hackage:0.5.4.3

See all snapshots wreq appears in

BSD-3-Clause licensed by Bryan O'Sullivan
Maintained by [email protected]
This version can be pinned in stack with:wreq-0.5.0.1@sha256:f7130edcf03cbf84d2c795a6edccf35b51eff2c5e5a0f12756cceb941b3bea08,5142

Module documentation for 0.5.0.1

wreq: a Haskell web client library Build Status

wreq is a library that makes HTTP client programming in Haskell easy.

Features

  • Simple but powerful lens-based API

  • Over 100 tests, and built on reliable libraries like http-client and lens

  • Session handling includes connection keep-alive and pooling, and cookie persistence

  • Automatic decompression

  • Powerful multipart form and file upload handling

  • Support for JSON requests and responses, including navigation of schema-less responses

  • Basic and OAuth2 bearer authentication

  • Amazon Web Services (AWS) request signing (Version 4)

  • AWS signing supports sending requests through the Runscope Inc. Traffic Inspector

Tutorials

See the tutorials for a quick-start.

Is it done?

No! See TODO.md for a rather long list of ideas.

Changes

-- markdown --

2017-01-09 0.5.0.0

  • Compatible with http-client >= 0.5

  • This compatibility change required a small API change: checkStatus is now named checkResponse for compatibility with the http-client package

2015-05-10 0.4.0.0

  • Compatible with GHC 7.10.

  • New withAPISession and withSessionControl functions make talking to REST services more efficient.

  • Added support for AWS S3 virtual-host style URLs.

  • Added signing support for region specific calls to the AWS Security Token Service (AWS STS).

  • The introduction of AWS support accidentally introduced unwanted AWS headers and computation into all requests. This has been fixed.

2014-12-11 0.3.0.1

  • Bump lower bound on http-client to 0.3.0.1

2014-12-02 0.3.0.0

  • Support for Amazon Web Services request signing

  • New customMethod, customMethodWith functions allow use of arbitrary HTTP verbs

  • httpProxy, basicAuth, oauth2Bearer, oauth2Token: removed Maybe from result types, changed documentation to suggest use of (?~)

2014-08-25 0.2.0.0

  • Support for lens 4.4

2014-04-22 0.1.0.0

  • Initial release.