Ruby's Psych YAML emitter & loader in pure Go — MRI-compatible, no cgo.
🌐 Website · 📚 Documentation
go-ruby-yaml is a pure-Go (no cgo) reimplementation of Ruby's Psych YAML library — a Dump emitter and a Load / SafeLoad loader that match reference Ruby's serialization byte-for-byte. It round-trips Ruby values through YAML the way Psych does: anchors and aliases for shared and cyclic structure, the !ruby/object: and related Ruby tags, Symbol / Time / Range / bignum scalars, and both block and flow styles. It was extracted from rbgo's prelude/internals into a reusable standalone library: no dependency on the Ruby runtime, the dependency runs the other way. It is the YAML backend for go-embedded-ruby, bound by rbgo as a native module just like go-ruby-regexp and go-ruby-erb — differential-tested against MRI, 100% coverage, CI green across 6 arches and 3 OSes.
| Repo | What it is |
|---|---|
| yaml | the library: Ruby's Psych YAML in pure Go |
| docs | MkDocs Material documentation, versioned with mike, served at /docs/ |
| go-ruby-yaml.github.io | the Hugo landing page |
| brand | logos and brand assets |
- Pure Go, zero cgo. Cross-compiles and embeds anywhere; a static binary by default.
- Extracted from rbgo, reusable by anyone. A standalone library lifted from
rbgo's prelude/internals;
rbgobinds it as a native module, the same pattern as go-ruby-regexp and go-ruby-erb. - MRI byte-exact. Output matches reference Ruby exactly, validated by a
differential oracle against the
rubybinary. - Standalone & reusable. No dependency on the Ruby runtime; the dependency runs the other way.
- 100% test coverage is the target, enforced as a CI gate.
Complete — MRI byte-exact. Faithful port of Ruby's Psych: Dump emitter and Load / SafeLoad loader, with anchors and aliases, the !ruby/object: Ruby tags, Symbol / Time / Range / bignum scalars, and both block and flow styles. Validated by a differential oracle against the system ruby / Psych — emitted YAML and loaded values compared byte-for-byte — at 100% coverage, gofmt + go vet clean, CI green across the six 64-bit Go targets and three OSes.
Differential-tested against MRI at 100% coverage, gofmt + go vet clean, CI
green across the six 64-bit Go targets (amd64, arm64, riscv64, loong64, ppc64le,
s390x) and three operating systems. It is bound into the
go-embedded-ruby (rbgo) ecosystem
as a native module.
BSD-3-Clause.