~ehmry/preserves-nim

Nim implementation of the Preserves data language
Update build metadata
Hash nil embedded pointers
Add pop for dictionaries

clone

read-only
https://git.sr.ht/~ehmry/preserves-nim
read/write
git@git.sr.ht:~ehmry/preserves-nim

You can also use your local clone with git send-email.

#Preserves

Nim implementation of the Preserves data language.

If you don't know why you need Preserves, see the Syndicate library.

#Library

To parse or produce Preserves one should write a schema and generate a Nim module using the preserves_schema_nim utility. This module will contain Nim types corresponding to schema definitions. The toPreserve andfromPreserve routines will convert Nim types to and from Preserves. The decodePreserves, parsePreserves, encode, and $ routines will convert Preserve objects to and from binary and textual encoding.

To debug the toPreserves and fromPreserves routines compile with -d:tracePreserves.

#Utilities

  • preserves_schema_nim
  • preserves_encode
  • preserves_decode
  • preserves_from_json
  • preserves_to_json

#Installation

preserves_encode is a multi-call binary that implements preserves_encode, preserves_decode, preserves_from_json, and preserves_to_json, so the appropriate symlinks should be created during packaging.