http-api-data: Converting to/from HTTP API data like URL pieces, headers and query parameters.

Versions [RSS]	0.1.0, 0.1.1, 0.1.1.1, 0.2, 0.2.1, 0.2.2, 0.2.3, 0.2.4, 0.3, 0.3.1, 0.3.2, 0.3.3, 0.3.4, 0.3.5, 0.3.6, 0.3.7, 0.3.7.1, 0.3.7.2, 0.3.8, 0.3.8.1, 0.3.9, 0.3.10, 0.4, 0.4.1, 0.4.1.1, 0.4.2, 0.4.3, 0.5, 0.5.1, 0.6, 0.6.1, 0.6.2 (info)
Change log	CHANGELOG.md
Dependencies	attoparsec (>=0.13.0.1 && <0.14), attoparsec-iso8601 (>=1.0.0.0 && <1.1), base (>=4.7 && <4.11), bytestring (>=0.10.4.0 && <0.11), containers (>=0.5.5.1 && <0.6), hashable (>=1.1.2.4 && <1.3), http-types (>=0.8.6 && <0.13), text (>=1.1.1.3 && <1.3), time (>=1.4.2 && <1.9), time-locale-compat (>=0.1.1.0 && <0.2), unordered-containers (>=0.2.5.0 && <0.3), uri-bytestring (>=0.1.7 && <0.4), uuid-types (>=1.0.2 && <1.1) [details]
Tested with	ghc ==7.8.4, ghc ==7.10.3, ghc ==8.0.2, ghc ==8.2.2
License	BSD-3-Clause
Author	Nickolay Kudasov <nickolay.kudasov@gmail.com>
Maintainer	Nickolay Kudasov <nickolay.kudasov@gmail.com>
Category	Web
Home page	http://github.com/fizruk/http-api-data
Source repo	head: git clone https://github.com/fizruk/http-api-data
Uploaded	by phadej at 2018-01-29T12:02:35Z
Distributions	Arch:0.5.1, Debian:0.4.1.1, Fedora:0.5.1, LTSHaskell:0.6.2, NixOS:0.5.1, Stackage:0.6.2, openSUSE:0.6.1
Reverse Dependencies	150 direct, 986 indirect [details]
Downloads	84235 total (28 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2018-01-29 [all 1 reports]

Readme for http-api-data-0.3.7.2

[back to package description]

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!