aeson: Fast JSON parsing and encoding

[ bsd3, json, library, text, web ] [ Propose Tags ]

A JSON parsing and encoding library optimized for ease of use and high performance.

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: 29945 msg/sec (24.4 MB/sec)

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

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

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

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

  • 11.8 KB, 64-bit GHC 7.0.3: 3059 msg/sec (35.2 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: 1050 msg/sec (32.0 MB/sec)

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

  • 61.5 KB, 64-bit GHC 7.0.3: 505 msg/sec (30.3 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: 2257 msg/sec (32.2 MB/sec)

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

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

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

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

  • 82.9 KB, 64-bit GHC 7.0.3: 322 msg/sec (26.0 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 (info)
Dependencies attoparsec (>=0.8.6.1), base (>=4 && <5), blaze-builder (>=0.2.1.4), blaze-textual, bytestring, containers (>=0.4.2.1), deepseq, hashable (>=1.1.2.0 && <1.2), mtl, old-locale, syb, text (>=0.11.0.2), time (>=1.1.3 && <1.5), unordered-containers (>=0.1.2.0), vector (>=0.7) [details]
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 4 made by phadej at 2021-10-20T14:58:38Z
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-05-12T18:12:08Z
Distributions Arch:1.5.6.0, Debian:1.4.7.1, Fedora:1.5.6.0, FreeBSD:0.8.0.2, LTSHaskell:2.0.3.0, NixOS:2.0.3.0, Stackage:2.0.3.0, openSUSE:1.5.6.0
Downloads 567372 total (1189 in the last 30 days)
Rating 3.0 (votes: 38) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for aeson-0.3.2.6

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