2023-03-16 16:51:19 +00:00
|
|
|
# Overview
|
|
|
|
|
2023-03-16 20:31:24 +00:00
|
|
|
```shell
|
|
|
|
pip install preserves
|
|
|
|
```
|
|
|
|
|
|
|
|
This package ([`preserves` on pypi.org](https://pypi.org/project/preserves/)) implements
|
|
|
|
[Preserves](https://preserves.dev/) for Python 3.x. It provides the core [semantics][] as well
|
2023-03-17 14:45:19 +00:00
|
|
|
as both the [human-readable text syntax](text) (a superset of JSON) and [machine-oriented
|
|
|
|
binary format](binary) (including
|
|
|
|
[canonicalization](https://preserves.dev/canonical-binary.html)) for Preserves. It also
|
|
|
|
implements [Preserves Schema](schema) and [Preserves Path](path).
|
2023-03-16 16:51:19 +00:00
|
|
|
|
2023-03-16 23:07:27 +00:00
|
|
|
- Main package API: [preserves](api)
|
2023-03-16 16:51:19 +00:00
|
|
|
|
|
|
|
## What is Preserves?
|
|
|
|
|
|
|
|
{% include "what-is-preserves.md" %}
|
|
|
|
|
|
|
|
## Mapping between Preserves values and Python values
|
|
|
|
|
|
|
|
Preserves `Value`s are categorized in the following way:
|
|
|
|
|
|
|
|
{% include "value-grammar.md" %}
|
|
|
|
|
2023-03-16 23:07:27 +00:00
|
|
|
{% include "python-representation.md" %}
|
2023-03-16 16:51:19 +00:00
|
|
|
|
|
|
|
[semantics]: https://preserves.dev/preserves.html#semantics
|