NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #2118 by repository stars
Latest stable
v0.42.4
Last release 14 days ago
08 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
471 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
libopenapi v0.42.4 improves schema fidelity, mock generation and reference resolution. It also fixes Arazzo conditions so 0 and 1 are treated as numbe
libopenapi v0.42.4 improves schema fidelity, mock generation and reference resolution. It also fixes Arazzo conditions so 0 and 1 are treated as numbers, and updates JSONPath with support for JSONPath Plus backtick member escapes.
@Tjmstudios @rriski
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixes some things, performance boost on indexing too from @Tjmstudios
Fixes some things, performance boost on indexing too from @Tjmstudios
Nothing published for this version
More accurate comparisons: count allOf breaking changes once and include changes inside retargeted references. Reports and change totals can differ fr…
This release improves reference resolution, bundling, and schema comparison across OpenAPI and Swagger documents. It fixes missing schema fields, incomplete bundles, incorrect circular-reference paths, and recursive comparisons that could panic or stall. It also fixes a shared-index race affecting Vacuum when multiple documents use the same cached filesystem.
Compatibility has been verified against unmodified Vacuum and openapi-changes, including full test suites, targeted race checks, and CLI runs across six real-world specifications. Linux, Windows, and the full library race suite pass, with 100% project and patch coverage. Benchmarks show faster indexing and comparison overall, though gains vary by specification and operation.
@CaliLuke @josephaxisa @madesst
Nothing published for this version
Faster schema comparisons: reuse cached quick hashes before building referenced schemas, reducing processing time and allocations when UseSchemaQuickH
Faster schema comparisons: reuse cached quick hashes before building referenced schemas, reducing processing time and allocations when UseSchemaQuickHash is enabled. (#670)
More accurate validation and change detection: compare enum entries by JSON value, fixing array/object false positives and numeric equality checks; correctly read whole-number floats such as maxLength: 2.0 in Swagger 2.0 parameters, items, and headers. (#656, #671)
@CaliLuke @youdie006 @josephaxisa
Nothing published for this version
This one stings a bit. With quick hash on (openapi-changes turns it on), a single circular reference made libopenapi treat every schema in the documen
This one stings a bit. With quick hash on (openapi-changes turns it on), a single circular reference made libopenapi treat every schema in the document as circular. Changes just vanished. I ran stripe.yaml against a copy with 300 breaking edits and got back zero. Zero.
Fixed. All 300 show up now. Big thanks to the contributors who chased down this one and three more. You lot are the best.
utils.ResolveMergeNodes.maxLength: 2.0 stops turning into 0. Huge values clamp, fractions stay unset.$ref found at any key position (#660, fixes #659). No more bogus "has no name value" errors in OpenAPI 3.1.NodeMap.GetNodeLines().golang.org/x/sync goes to 0.24.0.Upgrade, especially if you diff specs with cycles. Much more to come.
@CaliLuke @josephaxisa @navaneethan-ac9 @TastyHeadphones
Nothing published for this version
Fixes seeded mock generation determinism.
Fixes seeded mock generation determinism.
@tx3stn
Added upgrades to the Go SDK generator to allow imperfect OpenAPI specs to generate correctly.
Added upgrades to the Go SDK generator to allow imperfect OpenAPI specs to generate correctly.
Adds support for OpenAPI Overlays v1.2
Adds support for OpenAPI Overlays v1.2
This release improves handling of malformed documents, schema comparisons, reference bundling, and reproducible mock generation.
This release improves handling of malformed documents, schema comparisons, reference bundling, and reproducible mock generation.
@tx3stn @matoous
Update hashing performance. No fixes or features, just faster and more performant.
Update hashing performance. No fixes or features, just faster and more performant.
Stop duplicating files referenced from arrays
Stop duplicating files referenced from arrays
@mcstepp
Rendering DocuSign (JSON): 87% faster
First thing the fork fixed: the emitter kept every single event it ever wrote, for the entire document. Rendering Stripe now allocates 76% less memory, and bundling it 71% less.
Bonus: folded block scalars (>) no longer grow a blank line when rendered. Rendered output finally matches its source.
This one breaks things. Swap go.yaml.in/yaml/v4 for github.com/pb33f/go-yaml in your imports. The package is still called yaml, so it's a find and replace. If you pass *yaml.Node values in or out of libopenapi you have to do it, because the two node types are different types. jsonpath v0.8.4, ordered-map v2.3.2 and testify v0.1.1 have all made the same move.
NodeMap.Nodes is now a *low.NodeLines instead of a *sync.Map. Range, Load and Store take int line numbers, and Range visits lines in order. Most models get built and never read, so the line index only gets built when you ask for it.NodeReference.Context is gone. libopenapi only ever set it on a PathItem's operations. Use pathItem.Get.Value.GetContext() instead.ClearAllCaches. (#614, #615)BaseURL without a scheme could crash the whole process during remote lookups. Not anymore. (#578)$ref pointed at a sequence or scalar (like root tags). Fixed. (#607, #608)Format, ExclusiveMinimum and UniqueItems correctly. (#630)Big thanks to @SAY-5 for the composed bundler fix, and to @jhump, @jorgembfigueira, @sohamsengupta17, @dnovikoff, @zLc362 and @andrei-samofalov for the reports. Keep them coming.
There's still more blood in this stone. Much more to come.
Nothing published for this version
fix: initialize operation reference so a failed sibling cannot cause a nil panic
fix: initialize operation reference so a failed sibling cannot cause a nil panic
@SAY-5
This release adds a TypeScript model generator and improves OpenAPI 3.1 enum generation for Go. Both model targets build from the same schema IR.
This release adds a TypeScript model generator and improves OpenAPI 3.1 enum generation for Go. Both model targets build from the same schema IR.
@sloudel
v0.39.1 is a focused performance and correctness release for indexing large OpenAPI documents and generating reliable Go SDK clients.
v0.39.1 is a focused performance and correctness release for indexing large OpenAPI documents and generating reliable Go SDK clients.
@s04
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
A new Go SDK generator that produces resource-oriented clients, reachable models, typed responses and API errors, OpenAPI security handling, and optio
@sheidkamp @hdimer @HNO3Miracle
Nothing published for this version
v0.38.7 improves composed bundling by correctly lifting external Security Scheme references—including bare-file and component-fragment refs—into compo
v0.38.7 improves composed bundling by correctly lifting external Security Scheme references—including bare-file and component-fragment refs—into components.securitySchemes, with safeguards against misclassifying wrapper maps or complete OpenAPI documents. Arazzo engines can now inject a context-aware SleepFunc through EngineConfig, enabling replay-safe retry delays in durable workflow runtimes and deterministic tests while preserving existing behavior by default. This release also adds regression coverage for empty Security Requirement objects and updates golang.org/x/sync to v0.22.0.
@kriptoburak @khalidDaoud
Fixes https://github.com/daveshanley/vacuum/issues/928
Fixes https://github.com/daveshanley/vacuum/issues/928
Fixes #597
Fixes #597
Just an internal refactor and deduplication of code, and build speed upgrades. No fixes, no features, no breaking changes,
Just an internal refactor and deduplication of code, and build speed upgrades. No fixes, no features, no breaking changes,
Fixes concurrent rendering issues stemming from changes in how the YAML lib has changed between RCs
Fixes concurrent rendering issues stemming from changes in how the YAML lib has changed between RCs
#594
@gnuletik
Bumps to rc6 on yaml and fixed $def handling in bundler.
Bumps to rc6 on yaml and fixed $def handling in bundler.
Fixes #590 and moved to our own fork of testify
Fixes #590 and moved to our own fork of testify
Improves parse/index performance and memory use with lazy SpecInfo JSON generation, lower-allocation node indexing, faster component-path conversion,
Improves parse/index performance and memory use with lazy SpecInfo JSON generation, lower-allocation node indexing, faster component-path conversion, and reduced goroutine overhead in small translation/schema paths.
Adds SkipMetadataCollection for consumers that do not need diagnostic index metadata, allowing faster/lighter parsing for large documents.
Tightens YAML handling around duplicate keys, merge/root errors, empty overlays, and YAML v4 rc.5 rendering behavior.
Fixes OpenAPI 3.0 webhooks extraction so same-named scalar values no longer create empty webhook maps.
Improves change detection and generator metadata fidelity, including anchor-insensitive YAML comparisons and preserved/inferred
YAML tags for generated enum/const metadata.
@asadtariq96
Address issue #581
Address issue #581
Provides a deeper fix for #575
Provides a deeper fix for #575
Addresses regression identified in #575
Addresses regression identified in #575
New generator module that Generated Code and Specs.
New generator module that Generated Code and Specs.
https://pb33f.io/libopenapi/generating-code/ https://pb33f.io/libopenapi/parsing-code/
Code from OpenAPI and OpenAPI from Code, all built in. no deps. no run-time required.
Fixes issues with auto-detecting types when bundling by adding a source path to determine type cleanly. No breaking changes.
Fixes issues with auto-detecting types when bundling by adding a source path to determine type cleanly. No breaking changes.
Some specs with crazy max limits as traits were causing insane blowout mock generation. No breaking changes.
New budgeting controls and logic for rendering mocks. Some specs with crazy max limits as traits were causing insane blowout mock generation. No breaking changes.
No new features or breaking changes.
Various fixes with bundler dealing with rewriting relative paths in composed mode, some house-keeping and cleanup.
No new features or breaking changes.
Nothing published for this version
One column per quarter.