jrsonnet

++++

// Github sucks: I can't center those images the normal way: https://github.com/github/markup/issues/984 // [.text-center] // // // [.text-center] // -- // // // // --

What is it

Jsonnet is a data templating language

This Rust crate implements both jsonnet library and an alternative jsonnet executable based on it. For more information see bindings,Bindings.

Install

NixOS

jrsonnet is packaged in nixpkgs and maintained by @CertainLach

[source,sh]

nix-env -iA nixpkgs.jrsonnet

MacOS

jrsonnet is packaged to brew and maintained by @messense

[source,sh]

brew install jrsonnet

Windows/other linux distributions

You can get latest build of jrsonnet in releases.

Build from sources

jrsonnet should build on latest stable Rust version (probably on the oldest, but there is no MSRV policy provided)

Debug build will work too, but it is much slower than release

[source]

cargo build --release

Why?

There already are multiple implementations of this standard implemented in different languages:

• C++;
• Go;
• Scala.
• Another Rust impl appears.

This implementation shows performance better than all existing implementations. For more information see link:./docs/benchmarks.adoc[benchmarks]

Also, I wanted to experiment on new syntax features, and jrsonnet implements some of them. For more information see link:./docs/features.adoc[features]

In the end, it's always fun to implement something in Rust.

Bindings [[bindings]]

Rust

Jrsonnet is written in rust itself, so just add it as dependency

JavaScript/TypeScript (WASM)

//

WASM bindings are published to JSR as @jrsonnet/jrsonnet.

[source,sh]

deno add jsr:@jrsonnet/jrsonnet

// npm package (jrsonnet) is not yet published.

Python

Bindings are created and maintained by @messense

C/C++

Jrsonnet provides a standard libjsonnet.so shared library and should work as drop-in replacement for it

Other

Java bindings (Both JNI and WASM compiled to .class) are in progress

See link:./bindings/[bindings] for more information.