pip install preserves
This package (
preserves on pypi.org) implements
Preserves for Python 3.x. It provides the core semantics as well
as both the human-readable text syntax (a superset of JSON) and machine-oriented
binary format (including
canonicalization) for Preserves. It also
implements Preserves Schema and Preserves Path.
- Main package API: preserves
What is Preserves?
Preserves is a data model, with associated serialization formats.
It supports records with user-defined labels, embedded references, and the usual suite of atomic and compound data types, including binary data as a distinct type from text strings. Its annotations allow separation of data from metadata such as comments, trace information, and provenance information.
Preserves departs from many other data languages in defining how to compare two values. Comparison is based on the data model, not on syntax or on data structures of any particular implementation language.
Mapping between Preserves values and Python values
Values are categorized in the following way:
Value = Atom | Compound | Embedded Atom = Boolean | Float | Double | SignedInteger | String | ByteString | Symbol Compound = Record | Sequence | Set | Dictionary
Python's strings, byte strings, integers, booleans, and double-precision floats stand directly for their Preserves counterparts. Wrapper objects for Float and Symbol complete the suite of atomic types.
Python's lists and tuples correspond to Preserves
Sequences, and dicts and sets to
Set values, respectively. Preserves
Records are represented by
Record objects. Finally, embedded values are represented by
Created: March 16, 2023