5category: Text, Web, JSON
6copyright: (c) 2011-2016 Bryan O'Sullivan
7 (c) 2011 MailRank, Inc.
8author: Bryan O'Sullivan <bos@serpentine.com>
9maintainer: Adam Bergmark <adam@bergmark.nl>
10stability: experimental
11tested-with: GHC == 7.4.2, GHC == 7.6.3, GHC == 7.8.4, GHC == 7.10.3, GHC == 8.0.1
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 Parsing performance on a late 2013 MacBook Pro (2.6GHz Core i7),
25 running 64-bit GHC 7.10.1, for mostly-English tweets from Twitter's
28 * 6.4 KB payloads, English: 7570 msg\/sec (47.6 MB\/sec)
30 * 14.6 KB payloads, Japanese: 3261 msg\/sec (46.6 MB\/sec)
32 Encoding performance on the same machine and data:
34 * 6.4 KB payloads, English: 22738 msg\/sec (142.9 MB\/sec)
36 * 14.6 KB payloads, Japanese: 15911 msg\/sec (227.4 MB\/sec)
38 (A note on naming: in Greek mythology, Aeson was the father of Jason.)
46 benchmarks/Compare/*.hs
49 benchmarks/json-data/*.json
55 ffi/Data/Aeson/Parser/*.hs
57 tests/JSONTestSuite/test_parsing/*.json
58 tests/JSONTestSuite/test_transform/*.json
59 pure/Data/Aeson/Parser/*.hs
62 description: operate in developer mode
67 description: compile without optimizations
71flag bytestring-builder
72 description: Depend on the bytestring-builder package for backwards compatibility.
77 description: Controls whether to include c-ffi bits or pure haskell
82 default-language: Haskell2010
93 Data.Aeson.Encoding.Internal
95 Data.Aeson.Internal.Time
102 Data.Aeson.Encoding.Builder
103 Data.Aeson.Internal.Functions
104 Data.Aeson.Parser.Internal
105 Data.Aeson.Parser.Unescape
106 Data.Aeson.Parser.Time
107 Data.Aeson.Types.FromJSON
108 Data.Aeson.Types.Generic
109 Data.Aeson.Types.ToJSON
110 Data.Aeson.Types.Class
111 Data.Aeson.Types.Internal
114 attoparsec >= 0.13.0.1,
116 base-compat >= 0.9.1 && < 0.10,
117 containers >= 0.2.4.1,
122 scientific >= 0.3.4.7 && < 0.4,
123 tagged >=0.8.3 && <0.9,
124 template-haskell >= 2.7,
127 time-locale-compat >= 0.1.1 && < 0.2,
128 unordered-containers >= 0.2.5.0,
129 uuid-types >= 1.0.3 && <1.1,
132 if flag(bytestring-builder)
133 build-depends: bytestring >= 0.9 && < 0.10.4,
134 bytestring-builder >= 0.10.4 && < 1
136 build-depends: bytestring >= 0.10.4
139 -- `Data.Semigroup` and `Control.Monad.Fail` and `Control.Monad.IO.Class` are available in base only since GHC 8.0 / base 4.9
141 semigroups >= 0.18.2 && < 0.19,
142 transformers >= 0.2.2.0,
143 transformers-compat >= 0.3,
146 if !impl(ghc >= 7.10)
147 -- `Numeric.Natural` is available in base only since GHC 7.10 / base 4.8
148 build-depends: nats >= 1 && < 1.2
154 ghc-prof-options: -auto-all
161 include-dirs: include
162 if impl(ghcjs) || !flag(cffi)
164 other-modules: Data.Aeson.Parser.UnescapePure
166 c-sources: cbits/unescape_string.c
169 other-modules: Data.Aeson.Parser.UnescapeFFI
172 default-language: Haskell2010
173 type: exitcode-stdio-1.0
174 hs-source-dirs: tests ffi pure
176 c-sources: cbits/unescape_string.c
177 ghc-options: -Wall -threaded -rtsopts
180 Data.Aeson.Parser.UnescapeFFI
181 Data.Aeson.Parser.UnescapePure
182 DataFamilies.Properties
183 DataFamilies.Instances
184 DataFamilies.Encoders
192 SerializationFormatSpec
195 UnitTests.NullaryConstructors
199 QuickCheck >= 2.8 && <2.9.3,
201 integer-logarithms >= 1 && <1.1,
205 base-orphans >= 0.5.3 && <0.6,
211 generic-deriving >= 1.10 && < 1.12,
218 test-framework-hunit,
219 test-framework-quickcheck2,
223 unordered-containers,
226 quickcheck-instances >=0.3.12
228 if flag(bytestring-builder)
229 build-depends: bytestring >= 0.9 && < 0.10.4,
230 bytestring-builder >= 0.10.4 && < 1
232 build-depends: bytestring >= 0.10.4
236 semigroups >= 0.18.2 && < 0.19,
237 transformers >= 0.2.2.0,
238 transformers-compat >= 0.3
240 if !impl(ghc >= 7.10)
241 build-depends: nats >=1 && <1.2
244 build-depends: hashable-time >= 0.2 && <0.3
247 ghc-options: -fno-enable-rewrite-rules
249source-repository head
251 location: git://github.com/bos/aeson.git
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