Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 1.21 KB

README.md

File metadata and controls

37 lines (27 loc) · 1.21 KB
Raw

URI

Uniform Resource Identifier

The openURI library is intended to provide basic support for handling RFC3986 Unique Resource Identifiers. The palette exposes a set of URI composition and decomposition methods that act through regular expressions to manipulate the parts according to the norm.

Official terminology for URIs can be found at https://tools.ietf.org/html/rfc3986

As an example, let's consider the URI below: https://username:[email protected]:443/html/rfc3986?query=test&query2=test2#appendix-A

The library handles decomposition of the URI into its basic components:

  • scheme = https
  • authority = username:[email protected]:443
  • path = "html/rfc3986"
  • query = "query=test&query2=test2"
  • fragment = "#appendix-A"

Authority is further decomposable into:

  • userinfo = "username:password"
  • host = "tools.ietf.org"
  • port = "443"

Query can further be decomposed into key-value pairs:

  • array of key-value pairs
  • 1st pair: key = "query", value = "test"
  • 2nd pair: key = "query2", value = "test2"

UTF-8 encoding support from version 1.3.0

  • percent-encoding
  • html entities

Planned future development includes:

  • validation of URIs
  • recognition of URN and URL specificities, including IPv4 and IPv6