A low-level implementation of the Protocol Buffers (version 3) wire format.

proto3-wire

This library provides a low-level implementation of the Protocol Buffers version 3 wire format.

This library takes a minimalist approach, supporting only the basic wire format. In particular, correctness is left up to the user in many places (for example, ensuring that encoders use increasing field numbers).

There are approaches which can give more guarantees, such as Generics and Template Haskell, but those approaches are not implemented here and are left to higher-level libraries.

Building

Install Stack, clone this repository, and run:

stack build

To run tests or generate documentation, use

stack build [--test] [--haddock]

GHC Versions

GHC 9.8

Supported on Linux and Darwin.

GHC 9.6

Supported on Linux and Darwin.

GHC 9.4

Supported on Linux and Darwin.

GHC 9.2

Supported on Linux and Darwin.

GHC 9.0

Supported only on Linux because "crypton" fails a test on Darwin, probably due to this issue.

GHC 8.10.7

Supported on Linux and Darwin.