5category: Text, Web, JSON
6copyright: (c) 2011, 2012 Bryan O'Sullivan
7 (c) 2011 MailRank, Inc.
8author: Bryan O'Sullivan <bos@serpentine.com>
9maintainer: Bryan O'Sullivan <bos@serpentine.com>
10stability: experimental
11tested-with: GHC == 6.12.3, GHC == 7.0.4, GHC == 7.2.2
12synopsis: Fast JSON parsing and encoding
14homepage: https://github.com/bos/aeson
15bug-reports: https://github.com/bos/aeson/issues
18 A JSON parsing and encoding library optimized for ease of use
21 To get started, see the documentation for the @Data.Aeson@ module
24 For release notes, see
25 <https://github.com/bos/aeson/blob/master/release-notes.markdown>
27 Parsing performance on a late 2010 MacBook Pro (2.66GHz Core i7),
28 for mostly-English tweets from Twitter's JSON search API:
30 * 0.8 KB, 32-bit GHC 6.12.3: 30538 msg\/sec (24.9 MB\/sec)
32 * 0.8 KB, 64-bit GHC 7.0.3: 31204 msg\/sec (25.4 MB\/sec)
34 * 6.4 KB, 32-bit GHC 6.12.3: 6731 msg\/sec (42.3 MB\/sec)
36 * 6.4 KB, 64-bit GHC 7.0.3: 6627 msg\/sec (41.7 MB\/sec)
38 * 11.8 KB, 32-bit GHC 6.12.3: 3751 msg\/sec (43.2 MB\/sec)
40 * 11.8 KB, 64-bit GHC 7.0.3: 3381 msg\/sec (38.9 MB\/sec)
42 * 31.2 KB, 32-bit GHC 6.12.3: 1306 msg\/sec (39.8 MB\/sec)
44 * 31.2 KB, 64-bit GHC 7.0.3: 1132 msg\/sec (34.5 MB\/sec)
46 * 61.5 KB, 32-bit GHC 6.12.3: 616 msg\/sec (37.0 MB\/sec)
48 * 61.5 KB, 64-bit GHC 7.0.3: 534 msg\/sec (32.1 MB\/sec)
50 Handling heavily-escaped text is a little more work. Here is
51 parsing performance with Japanese tweets, where much of the text
52 is entirely Unicode-escaped.
54 * 14.6 KB, 32-bit GHC 6.12.3: 2315 msg\/sec (33.1 MB\/sec)
56 * 14.6 KB, 64-bit GHC 7.0.3: 1986 msg\/sec (28.4 MB\/sec)
58 * 44.1 KB, 32-bit GHC 6.12.3: 712 msg\/sec (30.7 MB\/sec)
60 * 44.1 KB, 64-bit GHC 7.0.3: 634 msg\/sec (27.3 MB\/sec)
62 * 82.9 KB, 32-bit GHC 6.12.3: 377 msg\/sec (30.5 MB\/sec)
64 * 82.9 KB, 64-bit GHC 7.0.3: 332 msg\/sec (26.9 MB\/sec)
66 Encoding performance on the same machine and data:
68 * English, 854 bytes: 43439 msg\/sec (35.4 MB/sec)
70 * English, 6.4 KB: 7127 msg\/sec (44.8 MB/sec)
72 * Engish, 61.5 KB: 765 msg\/sec (46.0 MB/sec)
74 * Japanese, 14.6 KB: 4727 msg\/sec (67.5 MB/sec)
76 * Japanese, 44.1 KB: 1505 msg\/sec (64.8 MB/sec)
78 (A note on naming: in Greek mythology, Aeson was the father of Jason.)
86 benchmarks/json-data/*.json
88 release-notes.markdown
92 description: operate in developer mode
106 Data.Aeson.Parser.Internal
107 Data.Aeson.Types.Class
108 Data.Aeson.Types.Internal
110 if impl(ghc >= 7.2.1)
111 cpp-options: -DGENERICS
112 build-depends: ghc-prim >= 0.2, dlist >= 0.2
114 Data.Aeson.Types.Generic
117 attoparsec >= 0.8.6.1,
119 blaze-builder >= 0.2.1.4,
127 template-haskell >= 2.4,
130 unordered-containers >= 0.1.3.0,
135 ghc-prof-options: -auto-all
137 ghc-options: -O2 -Wall
140 type: exitcode-stdio-1.0
141 hs-source-dirs: tests
142 main-is: Properties.hs
145 -Wall -threaded -rtsopts
156 test-framework-quickcheck2,
160source-repository head
162 location: git://github.com/bos/aeson.git
164source-repository head
166 location: https://bitbucket.org/bos/aeson
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list