binary-tagged: Tagged binary serialisation.
Downloads
- binary-tagged-0.1.5.2.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 0.1.0.0, 0.1.1.0, 0.1.2.0, 0.1.3.0, 0.1.3.1, 0.1.4.0, 0.1.4.1, 0.1.4.2, 0.1.5, 0.1.5.1, 0.1.5.2, 0.2, 0.3, 0.3.1 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | aeson (>=0.8 && <1.5), array (>=0.5.0.0 && <0.6), base (>=4.7.0.2 && <4.13), base16-bytestring (>=0.1.1.6 && <0.2), binary (>=0.7.1.0 && <0.10), bytestring (>=0.10.4.0 && <0.11), containers (>=0.5.5.1 && <0.7), generics-sop (>=0.3.2.0 && <0.6), hashable (>=1.2 && <1.4), nats (>=1.1.2 && <1.2), scientific (>=0.3 && <0.4), semigroups (>=0.18.5 && <0.20), SHA (>=1.6 && <1.7), tagged (>=0.7 && <0.9), text (>=1.2.3.0 && <1.3), time (>=1.4.2 && <1.9), unordered-containers (>=0.2 && <0.3), vector (>=0.10 && <0.13) [details] |
| Tested with | ghc ==7.8.4 || ==7.10.3 || ==8.0.2 || ==8.2.2 || ==8.4.4 || ==8.6.5 |
| License | BSD-3-Clause |
| Author | Oleg Grenrus <oleg.grenrus@iki.fi> |
| Maintainer | Oleg Grenrus <oleg.grenrus@iki.fi> |
| Uploaded | by phadej at 2019-05-10T17:35:05Z |
| Category | Data |
| Home page | https://github.com/phadej/binary-tagged#readme |
| Bug tracker | https://github.com/phadej/binary-tagged/issues |
| Source repo | head: git clone https://github.com/phadej/binary-tagged |
| Distributions | Arch:0.3.1, Debian:0.2 |
| Reverse Dependencies | 3 direct, 5 indirect [details] |
| Downloads | 15613 total (49 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2019-05-10 [all 1 reports] |
Readme for binary-tagged-0.1.5.2
[back to package description]binary-tagged
Structurally tag binary serialisation stream.
Say you have:
data Record = Record
{ _recordFields :: HM.HashMap Text (Integer, ByteString)
, _recordEnabled :: Bool
}
deriving (Eq, Show, Generic)
instance Binary Record
instance HasStructuralInfo Record
instance HasSemanticVersion Record
then you can serialise and deserialise Record values with a structure tag by simply
encodeTaggedFile "cachefile" record
decodeTaggedFile "cachefile" :: IO Record
If structure of Record changes in between, deserialisation will fail early.
The overhead is next to non-observable, see a simple benchmark and the results.