hack

Documentation

Overview

Package hack gives you some efficient functionality at the cost of breaking some Go rules.

Index

• func DisableProtoBufRandomness()
• func RuntimeAllocSize(size int64) int64
• func String(b []byte) (s string)
• func StringBytes(s string) []byte

Functions

func DisableProtoBufRandomness

func DisableProtoBufRandomness()

DisableProtoBufRandomness disables the random insertion of whitespace characters when serializing Protocol Buffers in textual form (both when serializing to JSON or to ProtoText)

Since the introduction of the APIv2 for Protocol Buffers, the default serializers in the package insert random whitespace characters that don't change the meaning of the serialized code but make byte-wise comparison impossible. The rationale behind this decision is as follows:

"The ProtoBuf authors believe that golden tests are Wrong"

Fine. Unfortunately, Vitess makes extensive use of golden tests through its test suite, which expect byte-wise comparison to be stable between test runs. Using the new version of the package would require us to rewrite hundreds of tests, or alternatively, we could disable the randomness and call it a day. The method required to disable the randomness is not public, but that won't stop us because we're good at computers.

Tracking issue: https://github.com/golang/protobuf/issues/1121

func RuntimeAllocSize

func RuntimeAllocSize(size int64) int64

RuntimeAllocSize returns size of the memory block that mallocgc will allocate if you ask for the size.

func String

func String(b []byte) (s string)

String force casts a []byte to a string. USE AT YOUR OWN RISK

func StringBytes

func StringBytes(s string) []byte

StringBytes returns the underlying bytes for a string. Modifying this byte slice will lead to undefined behavior.