http-link-header

HTTP Link header parser/writer

https://codeberg.org/valpackett/http-link-header

LTS Haskell 23.27:	1.2.3
Stackage Nightly 2025-07-12:	1.2.3
Latest on Hackage:	1.2.3

See all snapshots http-link-header appears in

LicenseRef-PublicDomain licensed by Val Packett

Maintained by [email protected]

This version can be pinned in stack with:http-link-header-1.2.3@sha256:9faac5d1cf901ae457e31199fc8730ff3fd9b7670a4bc3354bd698bb5a830be4,2222

Module documentation for 1.2.3

Network
- Network.HTTP
  - Network.HTTP.Link
    - Network.HTTP.Link.Parser
    - Network.HTTP.Link.Types
    - Network.HTTP.Link.Writer

Depends on 7 packages(full list with versions):

attoparsec, base, bytestring, errors, http-api-data, network-uri, text

Used by 2 packages in nightly-2025-07-12(full list with versions):

github, yesod-page-cursor

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"

License

This is free and unencumbered software released into the public domain.
For more information, please refer to the UNLICENSE file or unlicense.org.