preserves

Mirror of https://gitlab.com/preserves/preserves

Tony Garnock-Jones 1b4064b17c Release 2.0.0		3 days ago
_layouts	Proper layouting	2 years ago
_plugins	Proper layouting	2 years ago
doc	Update docs	4 weeks ago
git-hooks	Update pre-commit hook and clone path.bin to address #30.	1 month ago
historical	Move codec.md into historical folder	3 years ago
implementations	Release 2.0.0	3 days ago
path	Rename real to ~real, and add ~int to match	2 months ago
schema	Rename NamedSimplePattern_ -> Binding	3 months ago
tests	The Great Renaming: Pointer -> Embedded	4 months ago
.gitignore	First stab at specification of Schema	4 months ago
.gitlab-ci.yml	Update CI script	4 months ago
LICENSE	LICENSE, NOTICE, README.md	2 years ago
Makefile	The Racket preserves package needs a local copy of schema.prs for the package-builder to work. Use a git hook to keep it in sync with the master copy	4 months ago
NOTICE	Bump dates	4 months ago
README.md	Update docs	4 weeks ago
TODO.md	Note in TODO.md	11 months ago
TUTORIAL.md	MUCH simpler binary format, inspired by Syrup; alterations to text format	8 months ago
_config.yml	Exclude implementations/ from site	2 years ago
canonical-binary.md	The Great Renaming: Pointer -> Embedded	4 months ago
conventions.md	MUCH simpler binary format, inspired by Syrup; alterations to text format	8 months ago
index.md	Tweak jekyll setup	2 years ago
normalize.css	Proper layouting	2 years ago
notes.mb.md	Proper layouting	2 years ago
preserves-path.md	preserves-path examples	4 weeks ago
preserves-schema.md	Rename NamedSimplePattern_ -> Binding	3 months ago
preserves.css	Repair CSS problem exposed by recent Firefox update	9 months ago
preserves.el	Revised preserves.el instructions	7 months ago
preserves.md	Repair minor typo in appendix	4 months ago
questions.md	Whitespace questions	7 months ago
quoting.rkt	Explore quoting.	3 years ago
quoting.v	Drastically improve quoting.v - including a much better main theorem	1 year ago
representations.md	Proper layouting	2 years ago
setup.sh	The Racket preserves package needs a local copy of schema.prs for the package-builder to work. Use a git hook to keep it in sync with the master copy	4 months ago
why-not-json.md	Proper layouting	2 years ago

README.md

projectpages	projecttree	title	no_site_title
https://gitlab.com/preserves/preserves	https://gitlab.com/preserves/preserves/tree/main	Preserves: an Expressive Data Language	true

This repository contains a proposal and various implementations of Preserves, a new data model and serialization format in many ways comparable to JSON, XML, S-expressions, CBOR, ASN.1 BER, and so on.

WARNING Everything in this repository is experimental and in flux! The design of Preserves is not finalised and may change drastically. Please offer any feedback you may have with this in mind.

Core documents

Preserves data model and serialization formats

Preserves is defined in terms of a syntax-neutral data model and semantics which all transfer syntaxes share. This allows trivial, completely automatic, perfect-fidelity conversion between syntaxes.

Preserves tutorial
Preserves specification, including semantics, data model, textual syntax, and compact binary syntax
Canonical Form for Binary Syntax
Syrup, a hybrid binary/human-readable syntax for the Preserves data model

Preserves schema and queries

Implementations

Implementations of the data model, plus the textual and/or binary transfer syntaxes:

Preserves for Nim
Preserves for Python (pip install preserves)
Preserves for Racket (raco pkg install preserves)
Preserves for Rust (crates.io package)
Preserves for Squeak Smalltalk (Installer ss project: 'Preserves'; install: 'Preserves')
Preserves for TypeScript and JavaScript (yarn add @preserves/core)

Implementations of the data model, plus Syrup transfer syntax:

Tools

Preserves documents

preserves-tool, generic syntax translation and pretty-printing

Preserves Schema documents and codegen

Tools for working with Preserves Schema

Additional resources

Some conventions for common data types
Open questions; see also the issues list
Why not Just Use JSON?

Contact

Tony Garnock-Jones tonyg@leastfixedpoint.com