1# jrsonnet23## What is it45[Jsonnet](https://jsonnet.org/) is a json templating language67This crate implements both jsonnet library, and alternative jsonnet executable89## Why1011There is already 3 implementations of this standard: in [C++](https://github.com/google/jsonnet), in [Go](https://github.com/google/go-jsonnet/) and in [Scala](https://github.com/databricks/sjsonnet)1213It is fun to write one in Rust :D1415## Spec support1617- Can pass all of original `examples` tests18- Can pass all of original `test_suite` tests, expect those, which checks golden output for stacktraces (vanilla-like stacktraces are implemented, but look is not 100% identical): 1920## Bindings2122Jrsonnet implements standard `libjsonnet.so` shared library, and should work as drop-in replacement for it2324See `./bindings/`2526## Benchmark2728It is faster than golang implementation on mine kubernetes cluster configuration, which includes a lot of stuff, i.e prometheus operator2930Mine configuration contains two manifests, first one contains a lot of plain values, second one - a lot of computations3132- `gojsonnet` - golang impl33- `../../../../jsonnet-rs/target/release/jrsonnet` - this repo impl3435```markdown36# Manifest 1 (plain values)3738Benchmark #1: gojsonnet 02-prepare.jsonnet -J ../vendor/39 Time (mean ± σ): 647.4 ms ± 12.8 ms [User: 1.252 s, System: 0.069 s]40 Range (min … max): 626.0 ms … 668.7 ms 10 runs4142Benchmark #2: ../../../../jsonnet-rs/target/release/jrsonnet 02-prepare.jsonnet -J ../vendor/43 Time (mean ± σ): 163.7 ms ± 2.9 ms [User: 138.5 ms, System: 24.6 ms]44 Range (min … max): 161.4 ms … 174.0 ms 17 runs4546Summary47 '../../../../jsonnet-rs/target/release/jrsonnet 02-prepare.jsonnet -J ../vendor/' ran48 3.96 ± 0.10 times faster than 'gojsonnet 02-prepare.jsonnet -J ../vendor/'4950# Manifest 2 (computations)5152Benchmark #1: gojsonnet 03-deploy.jsonnet -J ../vendor/53 Time (mean ± σ): 14.387 s ± 0.473 s [User: 27.657 s, System: 0.226 s]54 Range (min … max): 13.865 s … 15.147 s 10 runs5556Benchmark #2: ../../../../jsonnet-rs/target/release/jrsonnet 03-deploy.jsonnet -J ../vendor/57 Time (mean ± σ): 2.373 s ± 0.083 s [User: 2.304 s, System: 0.063 s]58 Range (min … max): 2.286 s … 2.486 s 10 runs5960Summary61 '../../../../jsonnet-rs/target/release/jrsonnet 03-deploy.jsonnet -J ../vendor/' ran62 6.06 ± 0.29 times faster than 'gojsonnet 03-deploy.jsonnet -J ../vendor/'63```6465However, go impl still can be faster in some cases, because it curretly have more stdlib functions implemented in native, instead of stdlib (I.e `std.base64`)