http-media: Processing HTTP Content-Type and Accept headers

[ library, mit, web ] [ Propose Tags ]

This library is intended to be a comprehensive solution to parsing and selecting quality-indexed values in HTTP headers. It is capable of parsing both media types and language parameters from the Accept and Content header families, and can be extended to match against other accept headers as well. Selecting the appropriate header value is achieved by comparing a list of server options against the quality-indexed values supplied by the client.

In the following example, the Accept header is parsed and then matched against a list of server options to serve the appropriate media using mapAcceptMedia:

getHeader >>= maybe send406Error sendResourceWith . mapAcceptMedia
    [ ("text/html",        asHtml)
    , ("application/json", asJson)
    ]

Similarly, the Content-Type header can be used to produce a parser for request bodies based on the given content type with mapContentMedia:

getContentType >>= maybe send415Error readRequestBodyWith . mapContentMedia
    [ ("application/json", parseJson)
    , ("text/plain",       parseText)
    ]

The API is agnostic to your choice of server.

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0, 0.1.1, 0.2.0, 0.3.0, 0.4.0, 0.5.0, 0.5.1, 0.6.0, 0.6.1, 0.6.2, 0.6.3, 0.6.4, 0.7.0, 0.7.1, 0.7.1.1, 0.7.1.2, 0.7.1.3, 0.8.0.0, 0.8.1.0, 0.8.1.1
Change log CHANGES.md
Dependencies base (>=4.8 && <5), bytestring (>=0.10 && <0.13), case-insensitive (>=1.0 && <1.3), containers (>=0.5 && <0.7), utf8-string (>=0.3 && <1.1) [details]
License MIT
Copyright (c) 2012-2023 Timothy Jones
Author Timothy Jones
Maintainer Timothy Jones <tim@zmthy.net>
Revised Revision 1 made by TimothyJones at 2023-10-25T07:53:18Z
Category Web
Home page https://github.com/zmthy/http-media
Bug tracker https://github.com/zmthy/http-media/issues
Source repo head: git clone https://github.com/zmthy/http-media
Uploaded by TimothyJones at 2023-09-10T07:00:50Z
Distributions Arch:0.8.1.1, Debian:0.8.0.0, Fedora:0.8.0.0, LTSHaskell:0.8.1.1, NixOS:0.8.1.1, Stackage:0.8.1.1, openSUSE:0.8.1.1
Reverse Dependencies 152 direct, 659 indirect [details]
Downloads 48680 total (299 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2023-09-10 [all 1 reports]