HTTP-4000.2.8: A library for client-side HTTP

Portabilitynon-portable (not tested)
Stabilityexperimental
MaintainerGanesh Sittampalam <http@projects.haskell.org>
Safe HaskellNone

Network.HTTP.Proxy

Description

Handling proxy server settings and their resolution.

Synopsis

Documentation

data Proxy Source

HTTP proxies (or not) are represented via Proxy, specifying if a proxy should be used for the request (see setProxy)

Constructors

NoProxy

Don't use a proxy.

Proxy String (Maybe Authority)

Use the proxy given. Should be of the form http://host:port, host, host:port, or http://host. Additionally, an optional Authority for authentication with the proxy.

fetchProxy :: Bool -> IO ProxySource

fetchProxy flg gets the local proxy settings and parse the string into a Proxy value. If you want to be informed of ill-formed proxy configuration strings, supply True for flg. Proxy settings are sourced from the HTTP_PROXY environment variable, and in the case of Windows platforms, by consulting IE/WinInet's proxy setting in the Registry.

parseProxy :: String -> Maybe ProxySource

parseProxy str translates a proxy server string into a Proxy value; returns Nothing if not well-formed.