This is a test suite for benchmarking various Go serialization methods.

https://alecthomas.github.io/go_serialization_benchmarks

To benchmark and validate, without cloning the repository, replace the . from the commands below with github.com/alecthomas/go_serialization_benchmarks@latest.

To validate the correctness of the serializers:

To update the benchmark report:

To update the benchmark report with a longer benchmark run (to get more accurate results):

If correctness and interoperability are the most important factors JSON or Protobuf are your best options.

But as always, make your own choice based on your requirements.

Review the following instructions before opening the PR to add a new serializer:

• Create all the required serializer code in internal/.
• Add an entry to the serializer in benchmarks.go.
• If the serializer supports both reusing/not reusing its marshalling buffer:
  • Add both a serializer and serializer/reuse entries, each one respectively reusing/not reusing the resulting marshalling buffer. Set the BufferReuseMarshal flag accordingly.
• If the serializer supports both safe and unsafe string unmarshalling:
  • Add both a serializer and serializer/unsafe entries, each one respectively unmarshalling into safe and unsafe strings. Set the UnsafeStringUnmarshal flag accordingly.
• If the serializer supports both marshalling buffer reuse and unsafe string unmarshalling, merge both options into a single serializer/unsafe_reuse entry (check the baseline serializer for an example).
• Regenerate the report by running:

• Include the updated report data in your PR

The data being serialized is the following structure with randomly generated values: