capnp: Cap'n Proto for Haskell
A native Haskell implementation of the Cap'N Proto cerialization format.
This library is currently serialization-only. RPC support is planned but not yet implemented. It works, but bear in mind that the API is considered unstable, and is likely to change to accomodate RPC, facilitate improved performance, etc.
The Data.Capnp.Tutorial module is the best place to start reading; the
reference documentation can seem bewildering without that context.
[Skip to Readme]
Modules
[Index] [Quick Jump]
- Capnp
- Data
Downloads
- capnp-0.1.0.0.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.
| Versions [RSS] | 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.4.0.0, 0.5.0.0, 0.6.0.0, 0.6.0.1, 0.6.0.2, 0.6.0.3, 0.7.0.0, 0.8.0.0, 0.9.0.0, 0.10.0.0, 0.10.0.1, 0.11.0.0, 0.12.0.0, 0.12.1.0, 0.13.0.0, 0.14.0.0, 0.15.0.0, 0.16.0.0, 0.17.0.0, 0.18.0.0 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | array (>=0.5 && <0.6), base (>=4.10 && <5.0), binary (>=0.8.5 && <0.9), bytes (>=0.15.4 && <0.16), bytestring (>=0.10 && <0.11), capnp, cereal (>=0.5.5 && <0.6), containers (>=0.5.10 && <0.6), cpu (>=0.1.2 && <0.2), data-default (>=0.7.1 && <0.8), data-default-instances-vector (>=0.0.1 && <0.1), directory (>=1.3.0 && <1.4), dlist (>=0.8.0 && <0.9), exceptions (>=0.10.0 && <0.11), filepath (>=1.4.1 && <1.5), mtl (>=2.2.2 && <2.3), primitive (>=0.6.3 && <0.7), reinterpret-cast (>=0.1.0 && <0.2), text (>=1.2 && <2.0), transformers (>=0.5.2 && <0.6), utf8-string (>=1.0.1 && <1.1), vector (>=0.12.0 && <0.13), wl-pprint-text (>=1.2 && <1.3) [details] |
| Tested with | ghc ==8.2.1, ghc ==8.4.3 |
| License | MIT |
| Copyright | 2016-2018 haskell-capnp contributors (see CONTRIBUTORS file). |
| Author | Ian Denhardt |
| Maintainer | ian@zenhack.net |
| Revised | Revision 1 made by isd at 2018-10-23T19:34:17Z |
| Category | Data, Serialization |
| Home page | https://github.com/zenhack/haskell-capnp |
| Bug tracker | https://github.com/zenhack/haskell-capnp/issues |
| Source repo | head: git clone https://github.com/zenhack/haskell-capnp.git -b master |
| Uploaded | by isd at 2018-08-25T23:03:07Z |
| Distributions | |
| Executables | capnpc-haskell |
| Downloads | 6020 total (28 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2018-08-25 [all 1 reports] |
Readme for capnp-0.1.0.0
[back to package description]
A Haskell library for the Cap'N Proto Cerialization protocol.
Serialization (read & write) support is mostly finished, and already usable, with some limitations:
- Generated schema currently ignore type parameters (#29).
- Schema which define custom default values for fields of pointer type are rejected (#28).
- We currently do not correctly handle decoding lists of structs from non-composite lists (#27). This means that, contrary to the protocol evolution rules, it is not safe to change a field from type List(T) (where T is any non-struct type) to a list of a struct type.
There is a module Data.Capnp.Tutorial which contains an introduction
to the library; users are strongly encouraged to read this first, as
the reference documentation can be bewildering without that context.
The API is considered unstable. It will likely see changes, for the sake of polish, consistency, etc. as well as to improve performance and accommodate more features as we add them (RPC in particular will probably require changing some interfaces).