serialise

A binary serialisation library for Haskell values.

LTS Haskell 23.25:	0.2.6.1@rev:4
Stackage Nightly 2025-06-29:	0.2.6.1@rev:5
Latest on Hackage:	0.2.6.1@rev:5

See all snapshots serialise appears in

BSD-3-Clause licensed by Duncan Coutts

Maintained by [email protected], [email protected]

This version can be pinned in stack with:serialise-0.2.6.1@sha256:a67f89b5533b1148ad465dc7f24baeed2e2e9e7d81d2a147fc7fa8ff1089ca4d,8814

Module documentation for 0.2.6.1

Codec
- Codec.Serialise
  - Codec.Serialise.Class
  - Codec.Serialise.Decoding
  - Codec.Serialise.Encoding
  - Codec.Serialise.IO
  - Codec.Serialise.Internal
    - Codec.Serialise.Internal.GeneralisedUTF8
  - Codec.Serialise.Properties
  - Codec.Serialise.Tutorial

Depends on 15 packages(full list with versions):

array, base, bytestring, cborg, containers, ghc-prim, half, hashable, primitive, strict, text, these, time, unordered-containers, vector

Used by 7 packages in nightly-2025-06-29(full list with versions):

bcp47-orphans, dhall, massiv-serialise, rp-tree, tls, tls-session-manager, verbosity

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.

Changes

Revision history for serialise

0.2.6.1 – 2023-11-13

Support GHC 9.8

0.2.6.0 – 2022-09-24

Support GHC 9.4
Drop GHC 8.0 and 8.2 support

0.2.4.0 – UNRELEASED

Add instances for Data.Void, strict and these.

0.2.3.0 – 2020-05-10

Bounds bumps and GHC 8.10 compatibility

0.2.2.0 – 2019-12-29

Export encodeContainerSkel, encodeMapSkel and decodeMapSkel from Codec.Serialise.Class
Fix Serialise instances for TypeRep and SomeTypeRep (#216)
Bounds bumps and GHC 8.8 compatibility

0.2.1.0 – 2018-10-11

Bounds bumps and GHC 8.6 compatibility

0.2.0.0 – 2017-11-30

Improved robustness in presence of invalid UTF-8 strings
Add encoders and decoders for ByteArray
Export GSerialiseProd(..) and GSerialiseSum(..)

0.1.0.0 – 2017-06-28

First version. Released on an unsuspecting world.