http-api-data
Converting to/from HTTP API data like URL pieces, headers and query parameters.
http://github.com/fizruk/http-api-data
| Version on this page: | 0.2.1@rev:1 |
| LTS Haskell 24.27: | 0.6.3 |
| Stackage Nightly 2026-01-10: | 0.6.3 |
| Latest on Hackage: | 0.7 |
This version can be pinned in stack with:
http-api-data-0.2.1@sha256:d51bcb90ab64f4b262ddbd657f9306fc8d313a296faeffcd57f3b8ce974bc4e2,1745Module documentation for 0.2.1
Depends on 4 packages(full list with versions):
Used by 3 packages in lts-3.12(full list with versions):
http-api-data
This package defines typeclasses used for converting Haskell data types to and from HTTP API data.
Examples
Booleans:
>>> toUrlPiece True
"true"
>>> parseUrlPiece "false" :: Either Text Bool
Right False
>>> parseUrlPieces ["true", "false", "undefined"] :: Either Text [Bool]
Left "could not parse: `undefined'"
Numbers:
>>> toQueryParam 45.2
"45.2"
>>> parseQueryParam "452" :: Either Text Int
Right 452
>>> toQueryParams [1..5]
["1","2","3","4","5"]
>>> parseQueryParams ["127", "255"] :: Either Text [Int8]
Left "out of bounds: `255' (should be between -128 and 127)"
Strings:
>>> toHeader "hello"
"hello"
>>> parseHeader "world" :: Either Text String
Right "world"
Calendar day:
>>> toQueryParam (fromGregorian 2015 10 03)
"2015-10-03"
>>> toGregorian <$> parseQueryParam "2016-12-01"
Right (2016,12,1)
Contributing
Contributions and bug reports are welcome!