aeson: Fast JSON parsing and encoding
A JSON parsing and encoding library optimized for ease of use and high performance.
To get started, see the documentation for the Data.Aeson module
below.
Parsing performance on a late 2013 MacBook Pro (2.6GHz Core i7), running 64-bit GHC 7.10.1, for mostly-English tweets from Twitter's JSON search API:
6.4 KB payloads, English: 7570 msg/sec (47.6 MB/sec)
14.6 KB payloads, Japanese: 3261 msg/sec (46.6 MB/sec)
Encoding performance on the same machine and data:
6.4 KB payloads, English: 22738 msg/sec (142.9 MB/sec)
14.6 KB payloads, Japanese: 15911 msg/sec (227.4 MB/sec)
(A note on naming: in Greek mythology, Aeson was the father of Jason.)
[Skip to Readme]
Modules
[Index]
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| developer | operate in developer mode | Disabled |
| fast | compile without optimizations | Disabled |
Automatic Flags
| Name | Description | Default |
|---|---|---|
| bytestring-builder | Depend on the bytestring-builder package for backwards compatibility. | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- aeson-1.0.2.1.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
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
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.3.1.1, 0.3.2.0, 0.3.2.1, 0.3.2.2, 0.3.2.3, 0.3.2.4, 0.3.2.5, 0.3.2.6, 0.3.2.7, 0.3.2.8, 0.3.2.9, 0.3.2.10, 0.3.2.11, 0.3.2.12, 0.3.2.13, 0.3.2.14, 0.4.0.0, 0.4.0.1, 0.5.0.0, 0.6.0.0, 0.6.0.1, 0.6.0.2, 0.6.1.0, 0.6.2.0, 0.6.2.1, 0.7.0.0, 0.7.0.1, 0.7.0.2, 0.7.0.3, 0.7.0.4, 0.7.0.5, 0.7.0.6, 0.8.0.0, 0.8.0.1, 0.8.0.2, 0.8.1.0, 0.8.1.1, 0.9.0.0, 0.9.0.1, 0.10.0.0, 0.11.0.0, 0.11.1.0, 0.11.1.1, 0.11.1.2, 0.11.1.3, 0.11.1.4, 0.11.2.0, 0.11.2.1, 0.11.3.0, 1.0.0.0, 1.0.1.0, 1.0.2.0, 1.0.2.1, 1.1.0.0, 1.1.1.0, 1.1.2.0, 1.2.0.0, 1.2.1.0, 1.2.2.0, 1.2.3.0, 1.2.4.0, 1.3.0.0, 1.3.1.0, 1.3.1.1, 1.4.0.0, 1.4.1.0, 1.4.2.0, 1.4.3.0, 1.4.4.0, 1.4.5.0, 1.4.6.0, 1.4.7.0, 1.4.7.1, 1.5.0.0, 1.5.1.0, 1.5.2.0, 1.5.3.0, 1.5.4.0, 1.5.4.1, 1.5.5.0, 1.5.5.1, 1.5.6.0, 2.0.0.0, 2.0.1.0, 2.0.2.0, 2.0.3.0, 2.1.0.0, 2.1.1.0, 2.1.2.0, 2.1.2.1, 2.2.0.0, 2.2.1.0, 2.2.2.0, 2.2.3.0 (info) |
|---|---|
| Change log | changelog.md |
| Dependencies | attoparsec (>=0.13.0.1 && <0.14), base (>=4.5 && <5), base-compat (>=0.9.1 && <0.10), bytestring (>=0.9 && <0.11), bytestring-builder (>=0.10.4 && <1), containers (>=0.4.2 && <0.6), deepseq (>=1.3 && <1.5), dlist (>=0.6 && <0.9), fail (>=4.9 && <4.10), ghc-prim (>=0.2), hashable (>=1.1.2.0 && <1.3), nats (>=1 && <1.2), scientific (>=0.3.4.7 && <0.4), semigroups (>=0.18.2 && <0.19), tagged (>=0.8.3 && <0.9), template-haskell (>=2.7 && <2.12), text (>=1.1.1.0 && <1.3), time (>=1.1.4 && <1.7), time-locale-compat (>=0.1.1 && <0.2), transformers (>=0.2.2.0 && <0.6), transformers-compat (>=0.3 && <0.6), unordered-containers (>=0.2.5.0 && <0.3), vector (>=0.8 && <0.13) [details] |
| Tested with | ghc ==7.4.2, ghc ==7.6.3, ghc ==7.8.4, ghc ==7.10.3, ghc ==8.0.1 |
| License | BSD-3-Clause |
| Copyright | (c) 2011-2016 Bryan O'Sullivan (c) 2011 MailRank, Inc. |
| Author | Bryan O'Sullivan <bos@serpentine.com> |
| Maintainer | Adam Bergmark <adam@bergmark.nl> |
| Revised | Revision 2 made by phadej at 2021-10-19T16:08:47Z |
| Category | Text, Web, JSON |
| Home page | https://github.com/bos/aeson |
| Bug tracker | https://github.com/bos/aeson/issues |
| Source repo | head: git clone git://github.com/bos/aeson.git head: hg clone https://bitbucket.org/bos/aeson |
| Uploaded | by AdamBergmark at 2016-10-22T13:55:44Z |
| Distributions | Arch:2.1.2.1, Debian:1.4.7.1, Fedora:2.1.2.1, FreeBSD:0.8.0.2, LTSHaskell:2.1.2.1, NixOS:2.1.2.1, Stackage:2.2.3.0, openSUSE:2.2.3.0 |
| Reverse Dependencies | 2337 direct, 5555 indirect [details] |
| Downloads | 594862 total (1470 in the last 30 days) |
| Rating | 3.0 (votes: 42) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2016-10-22 [all 1 reports] |
Readme for aeson-1.0.2.1
[back to package description]Welcome to aeson 
aeson is a fast Haskell library for working with JSON data.
Join in!
We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.
Please report bugs via the github issue tracker.
Master git repository:
git clone git://github.com/bos/aeson.git
There's also a Mercurial mirror:
hg clone http://bitbucket.org/bos/aeson
(You can create and contribute changes using either git or Mercurial.)
Authors
This library is written and maintained by Bryan O'Sullivan, bos@serpentine.com.