simd-json

High performance JSON parser based on a port of simdjson

16 releases

✓ Uses Rust 2018 edition

new 0.1.15 Jun 24, 2019
0.1.14 Jun 22, 2019
0.1.10 May 25, 2019
0.1.5 Apr 29, 2019

#15 in Hardware support

Download history 56/week @ 2019-04-15 50/week @ 2019-04-22 71/week @ 2019-04-29 44/week @ 2019-05-06 66/week @ 2019-05-13 75/week @ 2019-05-20 120/week @ 2019-05-27 115/week @ 2019-06-03 207/week @ 2019-06-10 131/week @ 2019-06-17

316 downloads per month

Apache-2.0/MIT

291KB
6.5K SLoC

SIMD Json for Rust   Build Status Windows Build Status Latest Version

Rust port of extremely fast simdjson JSON parser with serde compatibility.


readme (for real!)

CPU target

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.

jemalloc

If you are writing performance centric code, make sure to use jemalloc and not the system allocator (which has now become default in rust), it gives a very noticeable boost in performance.

serde

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.

serializing

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.

unsafe

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:

  • Poor old unit tests - to test general 'obvious' cases and edge cases as well as regressions
  • Property based testing on valid json - tests if valid but random generated json parses the same in simd-json and in serde-json (floats here are excluded since slighty different parsing algorihtms lead to slighty different results)
  • Property based testing on random 'human readable' data - make sure that randomly generated sequences of printable characters don't panic or crash the parser (they might and often error so - they are not valid json!)
  • Property based testing on random byte sequences - make sure that no random set of bytes will crash the parser
  • Fuzzing (using afl) - fuzz based on upstream simd pass/fail cases

This certainly doesn't ensure complete safety but it does go a long way.

Other interesting things

There are also bindings for simdjson available here

License

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.

Dependencies

~4MB
~54K SLoC