joetjen.net
EN DE
← Alle Bibliotheken
Elixir

dextrin

Die Referenzimplementierung von DXN (Data eXchange Notation) für Elixir: .dxn-Text, .dxnb-Binär, .dxns-Schema.

Absicht

JSON ist menschenlesbar, verliert aber Präzision; Protobuf ist kompakt und typisiert, braucht aber einen Compiler-Schritt und liest sich für niemanden. DXNs Grundidee: Text- und Binärdokument sollen denselben Werteraum beschreiben — 31 Typen, präzise genug für Geldbeträge und exakte Brüche, mit Structs und eigenen Tags als Erweiterungspunkten erster Klasse. Schemata tragen eine Version, Daten aus einer älteren werden also weiter gelesen und hochgestuft. Eine von Hand geschriebene .dxn-Datei lässt sich per Programm bearbeiten, ohne dass ein Kommentar verloren geht.

Beispiel
Dextrin.decode(~s(%{x: 1, y: 2}))
#=> {:ok, %{%Dextrin.Keyword{name: "x"} => 1, %Dextrin.Keyword{name: "y"} => 2}}

# trusted input may become atoms
{:ok, value} = Dextrin.decode(~s(%{x: 1, y: 2}), trusted: true)
#=> {:ok, %{x: 1, y: 2}}

{:ok, bytes} = Dextrin.encode_binary(value)
Dextrin.decode_binary(bytes, trusted: true)
#=> {:ok, %{x: 1, y: 2}}
Installation
{:dextrin, "~> 0.3.2"}
ElixirSerializationCBOR