Bryan O'Sullivan avatar Bryan O'Sullivan committed 4573c5d

More docs

Comments (0)

Files changed (3)

 -- Portability: portable
 --
 -- Types and functions for working efficiently with JSON data.
+--
+-- (A note on naming: in Greek mythology, Aeson was the father of Jason.)
 
 module Data.Aeson
     (
 bug-reports:     http://github.com/mailrank/aeson/issues
 build-type:      Simple
 description:
-    A fast JSON parsing and generation library.
+    A JSON parsing and generation library optimized for ease of use
+    and high performance.
+    .
+    Parsing performance with GHC 6.12.3 on a late 2010 MacBook Pro
+    (2.66GHz Core i7), for different message sizes:
+    .
+    * 854 bytes: 15308 msg\/sec (12.5 MB/sec)
+    .
+    * 6.4 KB: 2807 msg\/sec (17.6 MB/sec)
+    .
+    * 31.2 KB: 493 msg\/sec (15.0 MB/sec)
+    .
+    * 61.5 KB: 236 msg\/sec (14.2 MB/sec) 
+    .
+    Encoding performance on the same machine and data:
+    .
+    * 854 bytes: 72407 msg\/sec (59 MB/sec)
+    .
+    * 6.4 KB: 2098 msg\/sec (13.2 MB/sec)
+    .
+    * 31.2 KB: 422 msg\/sec (12.9 MB/sec)
+    .
+    * 61.5 KB: 219 msg\/sec (13.2 MB/sec)
+    .
+    (A note on naming: in Greek mythology, Aeson was the father of Jason.)
+
 extra-source-files:
     README.markdown
 
     base == 4.*,
     blaze-builder >= 0.2.1.4,
     bytestring,
-    containers == 0.3.*,
+    containers,
     deepseq,
     old-locale,
     text >= 0.11.0.2,

benchmarks/ParseFile.hs

             | good+bad >= count = return (good, bad)
             | otherwise = do
           hSeek h AbsoluteSeek 0
-          let refill = B.hGet h 1024
+          let refill = B.hGet h 16384
           result <- parseWith refill json =<< refill
           case result of
             Done _ r -> loop (good+1) bad
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.