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.

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/mailrank/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 && <4.5), blaze-builder (>=0.2.1.4), blaze-textual (>=0.2.0.2), bytestring, containers, deepseq (<1.2), hashable (>=1.1.2.0 && <1.2), mtl, old-locale, syb, template-haskell (>=2.5), text (>=0.11.0.2), time (>=1.1.3 && <1.5), unordered-containers (>=0.1.3.0), vector (>=0.7) [details]
Tested with ghc ==6.12.3
License BSD-3-Clause
Copyright Copyright 2011 MailRank, Inc.
Author Bryan O'Sullivan <bos@mailrank.com>
Maintainer Bryan O'Sullivan <bos@mailrank.com>
Revised Revision 3 made by phadej at 2021-10-20T14:58:36Z
Category Text, Web, JSON
Home page http://github.com/mailrank/aeson
Bug tracker http://github.com/mailrank/aeson/issues
Source repo head: git clone http://github.com/mailrank/aeson
head: hg clone http://bitbucket.org/bos/aeson
Uploaded by BryanOSullivan at 2011-09-19T18:46:14Z
Distributions Arch:2.1.2.1, Debian:1.4.7.1, Fedora:2.1.2.1, FreeBSD:0.8.0.2, LTSHaskell:2.2.3.0, NixOS:2.1.2.1, Stackage:2.2.3.0, openSUSE:2.2.3.0
Reverse Dependencies 2341 direct, 5568 indirect [details]
Downloads 595879 total (1055 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.3.2.12

[back to package description]

Welcome to aeson

aeson is a fast Haskell library for working with JSON data.

Important note for users of GHCi and Template Haskell

This package depends on the blaze-textual package , and is unfortunately subject to crashes if you use GHCi or Template Haskell in your work.

For complete details, including a workaround, see the writeup in the blaze-textual README.

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/mailrank/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@mailrank.com.