Skip to content

Why pure Go

go-eyaml is part of the pure-Go Puppet stack — a family of engines (alongside go-facter, go-hiera, go-pcore and go-puppet) that provide Puppet-ecosystem capabilities as ordinary Go libraries, with CGO_ENABLED=0 and no runtime dependency on Ruby or on a C toolchain.

Static, portable, embeddable

Because it is pure Go — the PKCS7 scheme on the standard library's crypto packages alone, the GPG scheme adding only the pure-Go ProtonMail/go-crypto/openpgp implementation — go-eyaml compiles with cgo disabled, cross-compiles to every 64-bit Go target (amd64, arm64, riscv64, loong64, ppc64le, s390x) and to WebAssembly, and links into a single static binary. There is nothing to install alongside it — no shared library, no interpreter, no external process it must shell out to.

Testability by construction

Every interaction with the outside world — file access, the environment, the network — flows through an injectable seam. That means both the happy path and every error branch are exercised deterministically against in-memory fixtures, which is how the project holds 100% coverage across operating systems and architectures from a single test suite, without special privileges.

An engine, not a framework

go-eyaml exposes a small, stable Go API and does one thing well — the eyaml scheme — as a dependency-light library you embed, not a service or CLI you must stand up.