A binary serialisation library for Haskell values.

Version on this page:
LTS Haskell 22.29:
Stackage Nightly 2024-07-21:
Latest on Hackage:

See all snapshots serialise appears in

BSD-3-Clause licensed by Duncan Coutts
This version can be pinned in stack with:serialise-,8242

This package (formerly binary-serialise-cbor) provides pure, efficient serialization of Haskell values directly into ByteStrings for storage or transmission purposes. By providing a set of type class instances, you can also serialise any custom data type you have as well.

The underlying binary format used is the 'Concise Binary Object Representation', or CBOR, specified in RFC 7049. As a result, serialised Haskell values have implicit structure outside of the Haskell program itself, meaning they can be inspected or analyzed without custom tools.

An implementation of the standard bijection between CBOR and JSON is provided by the cborg-json package. Also see cbor-tool for a convenient command-line utility for working with CBOR data.


Revision history for serialise – 2018-10-11

  • Bounds bumps and GHC 8.6 compatibility – 2017-11-30

  • Improved robustness in presence of invalid UTF-8 strings

  • Add encoders and decoders for ByteArray

  • Export GSerialiseProd(..) and GSerialiseSum(..) – 2017-06-28

  • First version. Released on an unsuspecting world.