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	base (>=4.7 && <4.10), bytestring, containers, hashable, text (>=0.5), time, time-locale-compat (>=0.1.1.0 && <0.2), unordered-containers, uri-bytestring, uuid-types (>=1.0.2 && <1.1) [details]
Tested with	ghc ==7.8.4, ghc ==7.10.3, ghc ==8.0.2, ghc >=8.1 && <8.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 NickolayKudasov at 2017-01-17T15:28:53Z
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 2017-01-17 [all 1 reports]

Readme for http-api-data-0.3.4

[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!