network-uri: URI manipulation

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

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

Backward-compatibility

In network-2.6 the Network.URI module was split off from the network package into this package. If you're using the Network.URI module you can be backward compatible and automatically get it from the right package by using the network-uri-flag pseudo-package in your .cabal file's build-depends (along with dependencies for both network-uri and network):

 build-depends:
    network-uri-flag == 0.1.*

Or you can do the same manually by adding this boilerplate to your .cabal file:

flag network-uri
  description: Get Network.URI from the network-uri package
  default: True

library
  -- ...
  if flag(network-uri)
    build-depends: network-uri >= 2.6, network >= 2.6
  else
    build-depends: network-uri < 2.6, network < 2.6

That is, get the module from either network < 2.6 or from network-uri >= 2.6.


[Skip to Readme]

Properties

Versions 2.5.0.0, 2.6.0.0, 2.6.0.1, 2.6.0.2, 2.6.0.3, 2.6.1.0, 2.6.2.0, 2.6.3.0, 2.6.3.1, 2.6.4.0, 2.6.4.1, 2.6.4.2, 2.7.0.0
Change log CHANGELOG.md
Dependencies base (>=3 && <5), deepseq (>=1.1 && <1.5), ghc-prim, parsec (>=3.1.12.0 && <3.2), template-haskell, th-compat (>=0.1 && <1.0) [details]
License BSD-3-Clause
Author
Maintainer ezra@ezrakilty.net
Category Network
Home page https://github.com/haskell/network-uri
Bug tracker https://github.com/haskell/network-uri/issues
Source repo head: git clone git://github.com/haskell/network-uri.git
Uploaded by EzraCooper at 2021-02-07T19:36:30Z

Modules

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Readme for network-uri-2.6.3.1

[back to package description]

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

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 "http://www.google.com/"

directButUnsafeURI :: URI
directButUnsafeURI = fromJust $ parseURI "http://www.google.com/"

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 "http://www.google.com")

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

directAndSafeURI :: URI
directAndSafeURI = [uri|"http://www.google.com"|]

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