aeson: Fast JSON parsing and encoding

[ bsd3, json, library, text, web ] [ Propose Tags ] [ Report a vulnerability ]

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.

For release notes, see https://github.com/bos/aeson/blob/master/release-notes.markdown

Note: if you use GHCi or Template Haskell, please see the README file for important details about building this package, and other packages that depend on it: https://github.com/bos/aeson#readme

Parsing performance on a late 2010 MacBook Pro (2.66GHz Core i7), for mostly-English tweets from Twitter's JSON search API:

  • 0.8 KB, 32-bit GHC 6.12.3: 30538 msg/sec (24.9 MB/sec)

  • 0.8 KB, 64-bit GHC 7.0.3: 31204 msg/sec (25.4 MB/sec)

  • 6.4 KB, 32-bit GHC 6.12.3: 6731 msg/sec (42.3 MB/sec)

  • 6.4 KB, 64-bit GHC 7.0.3: 6627 msg/sec (41.7 MB/sec)

  • 11.8 KB, 32-bit GHC 6.12.3: 3751 msg/sec (43.2 MB/sec)

  • 11.8 KB, 64-bit GHC 7.0.3: 3381 msg/sec (38.9 MB/sec)

  • 31.2 KB, 32-bit GHC 6.12.3: 1306 msg/sec (39.8 MB/sec)

  • 31.2 KB, 64-bit GHC 7.0.3: 1132 msg/sec (34.5 MB/sec)

  • 61.5 KB, 32-bit GHC 6.12.3: 616 msg/sec (37.0 MB/sec)

  • 61.5 KB, 64-bit GHC 7.0.3: 534 msg/sec (32.1 MB/sec)

Handling heavily-escaped text is a little more work. Here is parsing performance with Japanese tweets, where much of the text is entirely Unicode-escaped.

  • 14.6 KB, 32-bit GHC 6.12.3: 2315 msg/sec (33.1 MB/sec)

  • 14.6 KB, 64-bit GHC 7.0.3: 1986 msg/sec (28.4 MB/sec)

  • 44.1 KB, 32-bit GHC 6.12.3: 712 msg/sec (30.7 MB/sec)

  • 44.1 KB, 64-bit GHC 7.0.3: 634 msg/sec (27.3 MB/sec)

  • 82.9 KB, 32-bit GHC 6.12.3: 377 msg/sec (30.5 MB/sec)

  • 82.9 KB, 64-bit GHC 7.0.3: 332 msg/sec (26.9 MB/sec)

Encoding performance on the same machine and data:

  • English, 854 bytes: 43439 msg/sec (35.4 MB/sec)

  • English, 6.4 KB: 7127 msg/sec (44.8 MB/sec)

  • Engish, 61.5 KB: 765 msg/sec (46.0 MB/sec)

  • Japanese, 14.6 KB: 4727 msg/sec (67.5 MB/sec)

  • Japanese, 44.1 KB: 1505 msg/sec (64.8 MB/sec)

(A note on naming: in Greek mythology, Aeson was the father of Jason.)


[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
developer

operate in developer mode

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

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'.

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)
Dependencies attoparsec (>=0.8.6.1), base (>=4 && <5), blaze-builder (>=0.2.1.4), bytestring, containers, deepseq, dlist (>=0.2), ghc-prim (>=0.2), hashable (>=1.1.2.0 && <1.2), mtl, old-locale, syb, template-haskell (>=2.4 && <2.10), text (>=0.11.0.2), time (>=1.1.3 && <1.5), unordered-containers (>=0.1.3.0), vector (>=0.7.1) [details]
Tested with ghc ==6.12.3, ghc ==7.0.4, ghc ==7.2.2
License BSD-3-Clause
Copyright (c) 2011 Bryan O'Sullivan (c) 2011 MailRank, Inc.
Author Bryan O'Sullivan <bos@serpentine.com>
Maintainer Bryan O'Sullivan <bos@serpentine.com>
Revised Revision 3 made by phadej at 2021-10-20T14:58:40Z
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 BryanOSullivan at 2011-12-23T22:55:40Z
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 uploaded by user
Build status unknown [no reports yet]

Readme for aeson-0.5.0.0

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