Under the Hood: Building a High-Performance OpenAPI Parser in Go

At Speakeasy, the need to process thousands of OpenAPI specifications daily led to the creation of a custom high-performance OpenAPI parser in Go, designed to address limitations in existing libraries. The newly introduced library, github.com/speakeasy-api/openapi, offers precise modeling of the specification and high-performance capabilities for reading, validating, mutating, and transforming specs at scale, handling complex aspects such as dynamic types and reference resolution in OpenAPI documents. Utilizing a reflection-based marshaller, the library supports multiple OpenAPI versions, Swagger, Arazzo, and Overlays, emphasizing correctness and developer experience. It features a "Porcelain vs. Plumbing" design for optimized internal performance while providing a clean API, and accommodates reference resolution, validation, and complex spec handling with a unified ecosystem approach. Additionally, the library includes a comprehensive CLI tool that mirrors its core capabilities, facilitating tasks like bundling, inlining, and sanitizing specs, and ensuring seamless integration into Go programs or CI pipelines.

Use this post, company, and trend context to find content marketing opportunities, perform competitive analysis, or address product feature gaps via the Plushcap MCP server or the Plushcap API.