BSD-3-Clause licensed
Maintained by [email protected]
This version can be pinned in stack with:network-uri-,3163

Module documentation for

The network-uri package

This package provides facilities for parsing and unparsing URIs, and creating and resolving relative URI references, closely following the URI spec, IETF RFC 3986 [1].

The main module in this package, Network.URI, was split off from the network package in the network-2.6 release.


Network.URI.Static that allows you to declare static URIs in type-safe manner.

With the base module, when you declare a static URI, you need to either use Maybe URI or use URI and give up type safety.

safeButWrappedInMaybeURI :: Maybe URI
safeButWrappedInMaybeURI = parseURI ""

directButUnsafeURI :: URI
directButUnsafeURI = fromJust $ parseURI ""

This library allows you to write static URIs in type-safe manner by checking URIs at compile time using template haskell.

Now, you can write the following.

directAndSafeURI :: URI
directAndSafeURI = $$(staticURI "")

You can even use a quasi quote if you’d like.

directAndSafeURI :: URI
directAndSafeURI = [uri|""|]

These two expressions emit an error at compile time if a specified URI is malformed.


network-uri- (2022-12-18)

  • Fix warnings, -Wtrustworthy-safe and -Woperator-whitespace-ext-conflict on GHC 9.4.
  • Slightly improved test coverage.

network-uri- (2021-02-07)

  • Fix: Restore “Safe” designation which was accidentally removed.

network-uri- (2021-02-07)

  • Add compatibility with GHC 9.0.1.

network-uri- (2020-02-18)

  • Add official support for SafeHaskell NOTE: This is the first version whose SafeHaskell properties have become an intentional part of the API contract; previous versions were merely accidentally safe-inferred (or not depending on various factors; in other words, this was a fragile property).
  • Derive Lift instances using DeriveLift extension, when available.

network-uri- (2020-01-30)

  • Mark the modules as Safe for SafeHaskell.

network-uri- (2020-01-30)

  • Merge network-uri-static (Network.URI.Static) into this package, which offers a way to parse URI strings at compile time.
  • Add Lenses for the URI types
  • Add Generic instances for the URI type
  • Add Lift instances for the URI type
  • Optimize isReserved and related character-class functions.
  • Start to add some benchmarks for performance analysis
  • Fix a bug: Correctly parse IPv6 addresses in URIs.
  • Add rectify which normalizes a URI if it is missing certain separator characters required by the module. Some users found adding those characters inconvenient when building a URI from parts.
  • Add nullURIAuth and uriAuthToString, paralleling nullURI and uriToString.


  • Fix a bug with IPv4 address parsing.


  • Implement Generic and NFData.


  • Initial release: Module split off from network.