Rust port of extremely fast simdjson JSON parser with serde compatibility.
Currently tracking version 0.2.x of simdjson upstream (work in progress, feedback welcome!).
To be able to take advantage of simdjson your system needs to be SIMD compatible. This means to compile with native cpu support and the given features. Look at The cargo config in this repository to get an example.
simd-json.rs supports AVX2, SSE4.2 and NEON.
Unless the allow-non-simd feature is passed simd-json will fail to compile, this is to prevent unexpected slowness in fallback mode that can be hard to understand.
For best performance we highly suggest using mimalloc or jemalloc instead of the system allocator used by default.
simdjson-rs is compatible with serde and serde-json. The Value types provided implement serializers and deserializers. In addition to that simdjson-rs implements the Deserializer for the parser so it can deserialize anything that implements the serde Deserialize trait.
That said serde is contained in the serde_impl feature which is part of the default feature set, but it can be disabled.
The known-key feature changes hasher for the objects, from ahash to fxhash, ahash is faster at hashing and provides protection against DOS attacks by forcing multiple keys into a single hashing bucket. fxhash on the other hand allows for repeatable hashing results, that allows memorizing hashes for well known keys and saving time on lookups. In workloads that are heavy at accessing some well known keys this can be a performance advantage.
simdjson-rs is not capable of serializing JSON data as there would be very little gain by re-implementing it. For serialization, we recommend serde-json.
simdjson-rs uses a lot of unsafe code first of all since all SIMD-intrinsics are inherently unsafe and also to work around some bottlenecks introduced by rust's safe nature. This requires extra scrutiny and thus needs to be diligently tested according to these 5 steps:
This certainly doesn't ensure complete safety but it does go a long way.
There are also bindings for simdjson available here
simdjson-rs itself is licensed under either of
However it ports a lot of code from simdjson so their work and copyright on that should be respected along side.
The serde integration is based on their example and serde-json so again, their copyright should as well be respected.