litmuschaos/litmus-go

Litmus Go is a collection of chaos engineering experiments written in Go that demonstrates how to construct experiments with steady state checks, chaos result generation, chaos injection, post-chaos checks, event creation, and observability reporting.

The project addresses the need for Go-based implementations of chaos experiments within the Litmus framework. It serves as a sister repository to the Python-based experiments, providing developers with concrete examples of how to structure experiment business logic in Go. The repository includes a Litmus SDK that bootstraps new experiments by scaffolding files with placeholders based on developer-provided attributes, automatically organizing them by chaos category. The SDK can reuse existing chaos libraries or create new ones as needed, and it generates default pre- and post-chaos checks for both the application under test and auxiliary applications.

Teams building chaos experiments in Go should use this repository as a reference implementation and starting point. It suits projects that need to extend the Litmus chaos engineering framework with Go-based custom experiments and want to follow established patterns for steady state validation, result generation, and observability integration. The project positions itself as an extension to the main Litmus repository, which serves as the community-facing hub for the broader project.

The project maintains active engagement with its community through contribution pathways including issue reporting and documentation improvements. Development activity shows consistent attention to the codebase with regular updates and refinements to both the experiment examples and the SDK tooling. The maintainers actively support developers working with the framework through documentation and developer guides that explain how to use the SDK and contribute new experiments.