chaos

package

v0.12.0 Latest Latest Go to latest Published: Jun 11, 2026 License: MIT Imports: 2 Imported by: 0

Details

Package chaos provides utilities for chaos testing parsers with corrupt inputs.

Chaos testing intentionally corrupts valid inputs to verify parsers handle malformed data gracefully without panicking.

This section is empty.

This section is empty.

This section is empty.

type Corruptor struct {
	// contains filtered or unexported fields
}

Corruptor defines methods for corrupting input data.

func NewCorruptor(seed int64) *Corruptor

NewCorruptor creates a new Corruptor with the given seed.

func (c *Corruptor) Corrupt(input []byte) []byte

Corrupt applies a random corruption to the input.

func (c *Corruptor) CorruptN(input []byte, n int) []byte

CorruptN applies n random corruptions to the input.

func (c *Corruptor) GenerateCorpus(valid []byte, count int) [][]byte

GenerateCorpus generates a corpus of corrupted inputs from a valid input.

type Mutation int

Mutation represents a type of corruption applied to input.

const (
	ByteFlip Mutation = iota
	ByteDelete
	ByteInsert
	ByteReplace
	Utf8Corrupt
	Truncation
	BitInversion
)