The store package

[Tags:benchmark, library, mit, test]

[Skip to Readme]

Properties

Versions 0.1.0.0, 0.1.0.1, 0.2.0.0, 0.2.1.0, 0.2.1.1, 0.2.1.2, 0.3, 0.3.1, 0.4.0, 0.4.1 (info)
Change log ChangeLog.md
Dependencies array (>=0.5.0.0), async (>=2.0.2), base (>=4.7 && <5), base-orphans (>=0.4.3), base64-bytestring (>=0.1.1), bytestring (>=0.10.4.0), conduit (>=1.2.3.1), containers (>=0.5.5.1), contravariant (>=1.3), cryptohash (>=0.11.6), deepseq (>=1.3.0.2), directory (>=1.2), filepath (>=1.3), free (>=4.11), ghc-prim (>=0.3.1.0), hashable (>=1.2.3.1), hspec (>=2.1.2), hspec-smallcheck (>=0.3.0), integer-gmp (>=0.5.1.0), lifted-base (>=0.2.3.3), monad-control (>=0.3.3.0), mono-traversable (>=0.7.0), network (>=2.6.0.2), primitive (>=0.6), resourcet (>=1.1.3.3), safe (>=0.3.8), semigroups (>=0.8), smallcheck (>=1.1.1), store-core (==0.4.*), streaming-commons (>=0.1.10.0), syb (>=0.4.4), template-haskell (>=2.9.0.0), text (>=1.2.0.4), th-lift (>=0.7.1), th-lift-instances (>=0.1.4), th-orphans (>=0.12.2), th-reify-many (>=0.1.6), th-utilities (>=0.2), time (>=1.4.2), transformers (>=0.3.0.0), unordered-containers (>=0.2.5.1), vector (>=0.10.12.3), void (>=0.5.11) [details]
License MIT
Copyright 2016 FP Complete
Author
Maintainer Michael Sloan <sloan@fpcomplete.com>
Stability Unknown
Category Serialization, Data
Home page https://github.com/fpco/store#readme
Bug tracker https://github.com/fpco/store/issues
Source repository head: git clone https://github.com/fpco/store
Uploaded Sat Mar 4 06:40:29 UTC 2017 by MichaelSloan
Distributions Arch:0.4.1, NixOS:0.3.1, Stackage:0.4.1, Tumbleweed:0.3.1
Downloads 463 total (146 in the last 30 days)
Votes
0 []
Status Docs available [build log]
Last success reported on 2017-03-04 [all 1 reports]

Modules

[Index]

Flags

NameDescriptionDefaultType
comparison-benchDisabledManual
small-benchDisabledManual

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

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for store

Readme for store-0.4.1

store

The 'store' package provides efficient binary serialization. There are a couple features that particularly distinguish it from most prior Haskell serialization libraries:

  • Its primary goal is speed. By default, direct machine representations are used for things like numeric values (Int, Double, Word32, etc) and buffers (Text, ByteString, Vector, etc). This means that much of serialization uses the equivalent of memcpy.

    We have plans for supporting architecture independent serialization - see #36 and #31. This plan makes little endian the default, so that the most common endianness has no overhead.

  • Instead of implementing lazy serialization / deserialization involving multiple input / output buffers, peek an poke always work with a single buffer. This buffer is allocated by asking the value for its size before encoding. This simplifies the encoding logic, and allows for highly optimized tight loops.

  • store can optimize size computations by knowing when some types always use the same number of bytes. This allows us to compute the byte size of a Vector Int32 by just doing length v * 4.

It also features:

  • Optimized serialization instances for many types from base, vector, bytestring, text, containers, time, template-haskell, and more.

  • TH and GHC Generics based generation of Store instances for datatypes

  • TH generation of testcases.

Blog posts