The aeson package

[Tags: bsd3, library]

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:

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

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.

Encoding performance on the same machine and data:

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

[Skip to ReadMe]


Versions0.1.0.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, (info)
Change logNone available
Dependenciesattoparsec (>=, base (==4.*), blaze-builder (>=, blaze-textual (>=, bytestring, containers, deepseq, hashable (>= && <1.2), mtl, old-locale, syb, template-haskell (>=2.4 && <2.10), text (>=, time (<1.5), unordered-containers (>=, vector (>=0.7) [details]
CopyrightCopyright 2011 MailRank, Inc.
AuthorBryan O'Sullivan <>
MaintainerBryan O'Sullivan <>
CategoryText, Web, JSON
Home page
Bug tracker
Source repositoryhead: git clone
head: hg clone
UploadedWed Nov 30 19:24:26 UTC 2011 by BryanOSullivan
UpdatedWed May 27 11:21:04 UTC 2015 by AdamBergmark to revision 2
DistributionsDebian:, Fedora:, FreeBSD:, LTSHaskell:, NixOS:, Stackage:
Downloads226702 total (1642 in last 30 days)
8 []
StatusDocs uploaded by user
Build status unknown [no reports yet]




developeroperate in developer modeDisabledAutomatic

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


Maintainers' corner

For package maintainers and hackage trustees

Readme for aeson-

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:

There's also a Mercurial mirror:

(You can create and contribute changes using either git or Mercurial.)


This library is written and maintained by Bryan O'Sullivan,