Network.HTTP.Types.URI

A sequence of QueryItems.

An item from the query string, split up into two parts.

The second part should be Nothing if there was no key-value separator after the query item name.

Renders the given Query into a ByteString.

If you want a question mark (?) added to the front of the result, use True.

Renders the given Query into a Builder.

If you want a question mark (?) added to the front of the result, use True.

Split out the query string into a list of keys and values. A few importants points:

• The result returned is still bytestrings, since we perform no character decoding here. Most likely, you will want to use UTF-8 decoding, but this is left to the user of the library.

• Percent decoding errors are ignored. In particular, "%Q" will be output as "%Q".

• It decodes '+' characters to ' '

Same functionality as parseQuery, but with the option to decode '+' characters to ' ' or to preserve any '+' encountered.

If you want to replace any '+' with a space, use True.

Like Query, but with Text instead of ByteString (UTF8-encoded).

Convert QueryText to Query.

Convert Query to QueryText (leniently decoding the UTF-8).

Convert QueryText to a Builder.

If you want a question mark (?) added to the front of the result, use True.

Parse a QueryText from a ByteString. See parseQuery for details.

queryToQueryText . parseQuery

A sequence of SimpleQueryItems.

Simplified query item type without support for parameter-less items.

Convert SimpleQuery to Query.

Render the given SimpleQuery into a ByteString.

If you want a question mark (?) added to the front of the result, use True.

Parse SimpleQuery from a ByteString.

This uses parseQuery under the hood, and will transform any Nothing values into an empty ByteString.

Query with some characters that should not be escaped.

General form: a=b&c=d:e+f&g=h

Partially escaped query item.

The key will always be encoded using 'urlEncode True', but the value will be encoded depending on which EscapeItems are used.

Section of a query item value that decides whether to use regular URL encoding (using 'urlEncode True') with QE, or to not encode anything with QN.

Convert PartialEscapeQuery to ByteString.

If you want a question mark (?) added to the front of the result, use True.

>>> renderQueryPartialEscape True [("a", [QN "x:z + ", QE (encodeUtf8 "They said: \"שלום\"")])]"?a=x:z + They%20said%3A%20%22%D7%A9%D7%9C%D7%95%D7%9D%22"

Convert a PartialEscapeQuery to a Builder.

If you want a question mark (?) added to the front of the result, use True.

Extract whole path (path segments + query) from a RFC 2616 Request-URI.

Though a more accurate description of this function's behaviour is that it removes the domain/origin if the string starts with an HTTP protocol. (i.e. http:// or https://)

This function will not change anything when given any other ByteString. (except return a root path "/" if given an empty string)

>>> extractPath "/path""/path"

>>> extractPath "http://example.com:8080/path""/path"

>>> extractPath "http://example.com""/"

>>> extractPath """/"

>>> extractPath "www.google.com/some/path""www.google.com/some/path"

Encode a whole path (path segments + query).

Decode a whole path (path segments + query).

Encodes a list of path segments into a valid URL fragment.

This function takes the following three steps:

• UTF-8 encodes the characters.

• Prepends each segment with a slash.

• Performs percent-encoding on all characters that are not:

  • alphanumeric (i.e. A-Z and a-z)

  • digits (i.e. 0-9)

  • a dash '-', an underscore '_', a dot '.', or a tilde '~'

For example:

>>> encodePathSegments ["foo", "bar1", "~baz"]"/foo/bar1/~baz"

>>> encodePathSegments ["foo bar", "baz/bin"]"/foo%20bar/baz%2Fbin"

>>> encodePathSegments ["שלום"]"/%D7%A9%D7%9C%D7%95%D7%9D"

Huge thanks to Jeremy Shaw who created the original implementation of this function in web-routes and did such thorough research to determine all correct escaping procedures.

Like encodePathSegments, but without the initial slash.

Parse a list of path segments from a valid URL fragment.

Will also decode any percent-encoded characters.