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.

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]

Flags

Manual Flags

NameDescriptionDefault
developer

operate in developer mode

Disabled
fast

compile without optimizations

Disabled
Automatic Flags
NameDescriptionDefault
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

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)
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 3 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-08-07T12:40:52Z
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 2341 direct, 5567 indirect [details]
Downloads 595686 total (1346 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-08-07 [all 1 reports]

Readme for aeson-1.0.0.0

[back to package description]

Welcome to aeson Hackage Build Status

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.