http-client

An HTTP client engine, intended as a base layer for more user-friendly packages.

https://github.com/snoyberg/http-client

Version on this page:0.4.9@rev:1
LTS Haskell 24.28:0.7.19
Stackage Nightly 2026-01-17:0.7.19
Latest on Hackage:0.7.19

See all snapshots http-client appears in

MIT licensed by Michael Snoyman
Maintained by [email protected]
This version can be pinned in stack with:http-client-0.4.9@sha256:415ce68073b0e545301c082ed53d50048b32e06286948ab0295f1e64a2628cb7,4662

Module documentation for 0.4.9

http-client

An HTTP client engine, intended as a base layer for more user-friendly packages.

This codebase has been refactored from http-conduit.

Below is a series of cookbook recipes. A number of recipes exist elsewhere, including Network.HTTP.Client and Network.HTTP.Conduit. The goal is to expand this list over time.

Proxy environment variable

Use the following approach to get proxy settings from the http_proxy and https_proxy environment variables.

{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Client

main :: IO ()
main = do
    let settings = managerSetProxy
            (proxyEnvironment Nothing)
            defaultManagerSettings
    withManager settings $ \man -> do
    let req = "http://httpbin.org"
            -- Note that the following settings will be completely ignored.
            { proxy = Just $ Proxy "localhost" 1234
            }
    httpLbs req man >>= print

Changes

0.4.9

  • Add RequestBody smart constructors streamFile and streamFileObserved, the latter with accompanying type StreamFileStatus.

0.4.8.1

  • Automatically call withSocketsDo everywhere #107

0.4.8

  • Add the ResponseLengthAndChunkingBothUsed exception constructor #108

0.4.7.2

  • Improved timeout implementation for high contention cases #98

0.4.7.1

  • Fix for shared connections in proxy servers #103

0.4.7

0.4.6.1

Separate tests not requiring internet access. #93

0.4.6

Add onRequestBodyException to Request to allow for recovering from exceptions when sending the request. Most useful for servers which terminate the connection after sending a response body without flushing the request body.

0.4.5

Add openSocketConnectionSize and increase default chunk size to 8192.

0.4.4

Add managerModifyRequest field to ManagerSettings.

0.4.3

Add requestVersion field to Request.

0.4.2

The reaper thread for a manager will go to sleep completely when there are no connection to manage. See: https://github.com/snoyberg/http-client/issues/70

0.4.1

0.4.0