Network.HTTP.Base

An HTTP Request. The Show instance of this type is used for message serialisation, which means no body data is output.

An HTTP Response. The Show instance of this type is used for message serialisation, which means no body data is output, additionally the output will show an HTTP version of 1.1 instead of the actual version returned by a server.

The HTTP request method, to be used in the Request object. We are missing a few of the stranger methods, but these are not really necessary until we add full TLS.

Parse the authority part of a URL.

RFC 1732, section 3.1:

      //<user>:<password>@<host>:<port>/<url-path>
 Some or all of the parts "<user>:<password>@", ":<password>",
 ":<port>", and "/<url-path>" may be excluded.

ResponseData contains the head of a response payload; HTTP response code, accompanying text description + header fields.

For easy pattern matching, HTTP response codes xyz are represented as (x,y,z).

RequestData contains the head of a HTTP request; method, its URL along with the auxiliary/supporting header data.

NormalizeRequestOptions brings together the various defaulting/normalization options over Requests. Use defaultNormalizeRequestOptions for the standard selection of option

RequestNormalizer is the shape of a (pure) function that rewrites a request into some normalized form.

normalizeRequest opts req is the entry point to use to normalize your request prior to transmission (or other use.) Normalization is controlled via the NormalizeRequestOptions record.

getAuth req fishes out the authority portion of the URL in a request's Host header.

Used when we know exactly how many bytes to expect.

Used when nothing about data is known, Unfortunately waiting for a socket closure causes bad behaviour. Here we just take data once and give up the rest.

A necessary feature of HTTP/1.1 Also the only transfer variety likely to return any footers.

Maybe in the future we will have a sensible thing to do here, at that time we might want to change the name.

Remove leading crlfs then call readTillEmpty2 (not required by RFC)

Read lines until an empty line (CRLF), also accepts a connection close as end of input, which is not an HTTP/1.1 compliant thing to do - so probably indicates an error condition.

'mkRequest method uri' constructs a well formed request for the given HTTP method and URI. It does not normalize the URI for the request _nor_ add the required Host: header. That is done either explicitly by the user or when requests are normalized prior to transmission.

A default user agent string. The string is "haskell-HTTP/$version" where $version is the version of this HTTP package.

The version of this HTTP package as a string, e.g. "4000.1.2". This may be useful to include in a user agent string so that you can determine from server logs what version of this package HTTP clients are using. This can be useful for tracking down HTTP compatibility quirks.

Deprecated. Use defaultUserAgent

catchIO a h handles IO action exceptions throughout codebase; version-specific tweaks better go here.

getRequestVersion req returns the HTTP protocol version of the request req. If Nothing, the default httpVersion can be assumed.

getResponseVersion rsp returns the HTTP protocol version of the response rsp. If Nothing, the default httpVersion can be assumed.

setRequestVersion v req returns a new request, identical to req, but with its HTTP version set to v.

setResponseVersion v rsp returns a new response, identical to rsp, but with its HTTP version set to v.