http-link-header: A parser and writer for the HTTP Link header per RFC 5988
Please see the README on GitHub at https://github.com/myfreeweb/http-link-header#readme
[Skip to Readme]
Modules
[Index] [Quick Jump]
Downloads
- http-link-header-1.2.1.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
| Versions [RSS] | 0.1.0, 0.2.0, 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.0.3.1, 1.1.1, 1.2.0, 1.2.1 |
|---|---|
| Dependencies | attoparsec, base (>=4.3 && <5), bytestring, errors, http-api-data, network-uri, text [details] |
| License | LicenseRef-PublicDomain |
| Copyright | 2014-2021 Greg V <greg@unrelenting.technology> |
| Author | Greg V |
| Maintainer | stevenjshuck@gmail.com |
| Category | Web |
| Home page | https://github.com/myfreeweb/http-link-header#readme |
| Bug tracker | https://github.com/myfreeweb/http-link-header/issues |
| Source repo | head: git clone https://github.com/myfreeweb/http-link-header |
| Uploaded | by SShuck at 2021-10-10T13:54:30Z |
| Distributions | Debian:1.0.3.1, LTSHaskell:1.2.1, NixOS:1.2.1, Stackage:1.2.1 |
| Downloads | 8299 total (106 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2021-10-10 [all 1 reports] |
Readme for http-link-header-1.2.1
[back to package description]http-link-header 
A Haskell library than implements a parser and a writer for the HTTP Link header as specified in RFC 5988 "Web Linking".
Usage
import Network.HTTP.Link
import Network.URI
import Data.Maybe
----- Writing
writeLinkHeader [ Link (fromJust $ parseURI "https://example.com/hello%20world") [(Rel, "next"), (Title, "hello world")]
, Link (fromJust $ parseURI "https://yolo.tld") [(Rel, "license")] ]
-- "<https://example.com/hello%20world>; rel=\"next\"; title=\"hello world\", <https://yolo.tld>; rel=\"license\""
----- Parsing
parseLinkHeader "<https://example.com/2>; rel=\"next\", <https://example.com/0>; rel=prev"
-- Just [ Link https://example.com/2 [(Rel, "next")]
-- , Link https://example.com/0 [(Rel, "prev")] ]
Development
Use stack to build.
Use ghci to run tests quickly with :test (see the .ghci file).
$ stack build
$ stack test && rm tests.tix
$ stack bench
$ stack ghci --ghc-options="-fno-hpc"
Contributing
Please feel free to submit pull requests! Bugfixes and simple non-breaking improvements will be accepted without any questions :-)
By participating in this project you agree to follow the Contributor Code of Conduct.
The list of contributors is available on GitHub.
License
This is free and unencumbered software released into the public domain.
For more information, please refer to the UNLICENSE file or unlicense.org.