urilib

RFC-3986 URI Library for Erlang.

Parse and build URIs with automatic percent encoding and plus encoding of query arguments.

API

Functions

Function	Description
`build/1`	Build a URI from a `uri()` or `url`.
`parse/1`	Parse a URI from a string, returning a `uri()`.
`parse/2`	Parse a URI, returning the result as either a `uri()` or `url()`.
`percent_decode/1`	Decode a percent encoded string value.
`percent_encode/1`	Percent encode a string value.
`percent_encode/2`	Percent encode a string value, explicitly stating the desired case for hexidecimal values. Pass `uppercase` to the second value to have hex values returned as `%2F` instead of `%2f`.
`plus_decode/1`	Decode a percent encoded string value that uses pluses for spaces.
`plus_encode/1`	Percent encode a string value similar to `percent_encode/1`, but encodes spaces with a plus (`+`) instead of `%20`.
`plus_encode/2`	Percent encode a string value similar to `percent_encode/1`, but encodes spaces with a plus (`+`) instead of `%20`, explicitly stating the desired case for hexidecimal values. Pass `uppercase` to the second value to have hex values returned as `%2F` instead of `%2f`.

Types

Type	Definition
`scheme()`	`http
`username()`	`string()
`password()`	`string()
`userinfo()`	`{username(), password()}
`host()`	`string()`
`tcp_port()`	`integer()`
`authority()`	`{userinfo(), host(), tcp_port()}`
`path()`	`string()`
`query()`	`[tuple()
`fragment()`	`string()
`uri()`	`{scheme(), authority(), path(), query(), fragment()}`
`url()`	`{scheme(), username(), password(), host(), tcp_port(), path(), query(), fragment()}`

Example Usage

Eshell V7.2.1  (abort with ^G)
1> urilib:build({http, {{"guest", "guest"}, "localhost", 15672}, "/api/queues", [{"name", "test"}], undefined}).
"http://guest:guest@localhost:15672/api/queues?name=test"

2> urilib:build({http, "guest", "guest", "localhost", 15672, "/api/queues", [{"name", "test"}], undefined}).    
"http://guest:guest@localhost:15672/api/queues?name=test"

3> urilib:parse("http://guest:guest@localhost:15672/api/queues?name=test").
{http,{{"guest","guest"},"localhost",15672},
      "/api/queues",
      [{"name","test"}],
      undefined}