`1820422c7290`

2 files changed

modifiedREADME.mddiff before after both

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): ![Example output](./traces.png)1920## Bindings2122C bindings (libjsonnet.so) are WIP23JS bindings are WIP too, but also available in WASM form2425See them in `./bindings/jsonnet/`2627## Benchmark2829It is faster than golang implementation on mine kubernetes cluster configuration, which includes a lot of stuff, i.e prometheus operator3031Mine configuration contains two manifests, first one contains a lot of plain values, second one - a lot of computations3233- `gojsonnet` - golang impl34- `../../../../jsonnet-rs/target/release/jrsonnet` - this repo impl3536```markdown37# Manifest 1 (plain values)3839Benchmark #1: gojsonnet 02-prepare.jsonnet -J ../vendor/40  Time (mean ± σ):     647.4 ms ±  12.8 ms    [User: 1.252 s, System: 0.069 s]41  Range (min … max):   626.0 ms … 668.7 ms    10 runs4243Benchmark #2: ../../../../jsonnet-rs/target/release/jrsonnet 02-prepare.jsonnet -J ../vendor/44  Time (mean ± σ):     163.7 ms ±   2.9 ms    [User: 138.5 ms, System: 24.6 ms]45  Range (min … max):   161.4 ms … 174.0 ms    17 runs4647Summary48  '../../../../jsonnet-rs/target/release/jrsonnet 02-prepare.jsonnet -J ../vendor/' ran49    3.96 ± 0.10 times faster than 'gojsonnet 02-prepare.jsonnet -J ../vendor/'5051# Manifest 2 (computations)5253Benchmark #1: gojsonnet 03-deploy.jsonnet -J ../vendor/54  Time (mean ± σ):     14.387 s ±  0.473 s    [User: 27.657 s, System: 0.226 s]55  Range (min … max):   13.865 s … 15.147 s    10 runs5657Benchmark #2: ../../../../jsonnet-rs/target/release/jrsonnet 03-deploy.jsonnet -J ../vendor/58  Time (mean ± σ):      2.373 s ±  0.083 s    [User: 2.304 s, System: 0.063 s]59  Range (min … max):    2.286 s …  2.486 s    10 runs6061Summary62  '../../../../jsonnet-rs/target/release/jrsonnet 03-deploy.jsonnet -J ../vendor/' ran63    6.06 ± 0.29 times faster than 'gojsonnet 03-deploy.jsonnet -J ../vendor/'64```6566However, 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`)

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): ![Example output](./traces.png)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`)

addedbindings/README.mddiff before after both

--- /dev/null
+++ b/bindings/README.md
@@ -0,0 +1,7 @@
+# Native bindings
+
+Bindings are implemented in form of standard libjsonnet.so implementation
+
+Headers are described in `c/libjsonnet.h`, this file is exact copy from `C` implementation of jsonnet, plus additional jrsonnet-specific methods
+
+Bindings should work as drop-in replacement for standard impl