NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
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.
https://github.com/daveshanley/vacuum/issues/863
Fixes
Nothing published for this version
no new features, no breaking changes.
Fixes a number of issues in the new version of openapi-changes.
no new features, no breaking changes.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
New XML rendering capability in the mock renderer.
New XML rendering capability in the mock renderer.
Fixed a few glitches and reported issues.
No breaking changes.
Nothing published for this version
No breaking changes, no new features.
A big refactor of the low-level model, after years of growth and organic changes. runs faster and cooler now, fewer allocations, less memory, and less number crunching. runs fewer instructions faster, all for free.
Also fixes a bundling glitch that was keeping old references in play in the model after composed bundling.
No breaking changes, no new features.
Nothing published for this version
No breaking changes, no new features, 7% more efficient.
The release fixes an issue where $id was being parsed when inside examples. The index module was also heavily refactored to make it easier to read, operate, and understand, a huge cleanup of years of organic growth. Much more to come.
No breaking changes, no new features, 7% more efficient.
@luke-hagar-sp
Nothing published for this version
Fixes security issues and patches issues #545
Fixes security issues and patches issues #545
@zhirschtritt
Addresses https://github.com/pb33f/wiretap/issues/143 by adding reusable local reference-resolution helpers and ensuring that nested-reference context
Addresses https://github.com/pb33f/wiretap/issues/143 by adding reusable local reference-resolution helpers and ensuring that nested-reference context settings are consistently propagated from document-level config into index/resolver config.
@andreyyudin
Fixes issue https://github.com/daveshanley/vacuum/issues/821
Fixes issue https://github.com/daveshanley/vacuum/issues/821
Minor bugfix for vacuum and some multi-file lookup edge cases, no new features, no breaking changes.
Minor bugfix for vacuum and some multi-file lookup edge cases, no new features, no breaking changes.
Nothing published for this version
Docs https://pb33f.io/libopenapi/arazzo/
Docs https://pb33f.io/libopenapi/arazzo/
https://github.com/pb33f/libopenapi/pull/535
Updates JSONPath lookup in utils to be configuration-aware and safe with recent https://github.com/pb33f/jsonpath behavior, especially with respect to WithLazyContextTracking().
Different lookup scenarios need different execution behavior and safety constraints. This keeps existing behavior by default while allowing explicit control and preventing incorrect cache reuse across different JSONPath engine settings.
@andreyyudin
New CreateSchemaProxyRefWithSchema(ref string, schema *Schema) introduced
@1000p
Release() method to Documents that cascades releasing cached objects to allow GC to collect them.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
Adds a new ClearAllCaches() method to the top of the library.
Adds a new ClearAllCaches() method to the top of the library.
// ClearAllCaches resets every global in-process cache in libopenapi.
// Call this between document lifecycles in long-running processes
// (servers, CLI tools that process many specs) to release memory that
// would otherwise accumulate and never be garbage-collected.
func ClearAllCaches() {
...
No other new features or fixes.
Even more memory use and speed tuneups! This time, a little further down the stack. No breaking changes, no new features, just better memory use.
Even more memory use and speed tuneups! This time, a little further down the stack. No breaking changes, no new features, just better memory use.
Memory use and performance tune-ups; no new features, but did fix some goroutine leaks and added a public cache-clearing capability, which isn't usefu
Memory use and performance tune-ups; no new features, but did fix some goroutine leaks and added a public cache-clearing capability, which isn't useful unless you're building long-running services.
…JSON parsing during spec load can be avoided. No breaking changes.
After a couple of tune-ups, the default config is constructed properly now, and forced JSON parsing during spec load can be avoided. No breaking changes.
@its-hammer-time
Nothing published for this version
Fixed off by one issue in downstream applications
Fixed off by one issue in downstream applications
No breaking changes, no new features.
Addresses some downstream race conditions in tests for consuming apps. And added fragment support to #519
No breaking changes, no new features.
Introduces a new option on the DocumentConfiguration struct to address https://github.com/pb33f/libopenapi/issues/519
Introduces a new option on the DocumentConfiguration struct to address https://github.com/pb33f/libopenapi/issues/519
SkipExternalRefResolution will prevent any external references from being looked up or resolved. They won't hit the index, the resolver, or the rolodex; it will stop trying to look them up and just continue.
false by default, you have to turn it on.
Fixes issue #497 and cleans up a few more rolodex custom file system, resolving issues for nested file systems.
Fixes issue #497 and cleans up a few more rolodex custom file system, resolving issues for nested file systems.
Fixed regression in bundler for handling circular references under certain conditions. Improved the rolodex resolver for certain relative file systems
Fixed regression in bundler for handling circular references under certain conditions. Improved the rolodex resolver for certain relative file systems using custom file system implementations.
Also implemented fully correct $id resolving for references when present in schemas.
@califlower
Some small non-breaking fixes, mostly with edge cases and complex ref resolution on exploded file systems.
Some small non-breaking fixes, mostly with edge cases and complex ref resolution on exploded file systems.
@andreyyudin @tx3stn
The low-level models now have a unit32 return signature instead of [32]byte. This is a breaking change, but a worthwhile one as we now use maphash ins…
New hashing algorithm & OpenAPI Overlays 1.1.0 Support
The low-level models now have a unit32 return signature instead of [32]byte. This is a breaking change, but a worthwhile one as we now use maphash instead of SHA256 for hashing, which is much, much faster, 15x in most cases.
OpenAPI Overlays 1.1.0 is now supported, most importantly, the copy action.
Fixes a few issues: - #504 - #503 - #500 - #501
Fixes a few issues:
Nothing published for this version
Nothing published for this version
Fixes https://github.com/daveshanley/vacuum/issues/788
Fixes https://github.com/daveshanley/vacuum/issues/788
Added a new RenderingMode that is backwards compatible, allows for validation mode or bundling mode and only really affects discrimators and polymorphic schemas.
The rendering context is now available in the DynamicValue object.
Adds support for the last remaining (and pretty obscure JSON Schema props that were not being collected and parsed by the lib.
Adds support for the last remaining (and pretty obscure JSON Schema props that were not being collected and parsed by the lib.
$comment, contentSchema and $vocabulary All now supported correctly. This brings libopenapi into total compliance with JSON Schema 2020-12. All the things! we have all the things, finally.
Also the mock renderer now correctly listens for preferred names on examples. Fixed by @eridan-ltu
The bundler now has a StrictValidation field on BundleCompositionConfig that handles errors during a bundle composition.
https://github.com/pb33f/libopenapi/pull/482 @tx3stn
Docs and examples: https://pb33f.io/libopenapi/overlays/ Overlays specification: https://spec.openapis.org/overlay/v1.0.0.html
Support for overlays added.
Resolves issue #125
Docs and examples: https://pb33f.io/libopenapi/overlays/ Overlays specification: https://spec.openapis.org/overlay/v1.0.0.html
Address #309 Address #471 Addresses: https://github.com/daveshanley/vacuum/issues/485
Address #309 Address #471 Addresses: https://github.com/daveshanley/vacuum/issues/485
Addresses non-deterministic behavior in reference extraction and resolution by introducing deterministic ordering through map key sorting, using singl
Addresses non-deterministic behavior in reference extraction and resolution by introducing deterministic ordering through map key sorting, using singleflight for deduplication of concurrent lookups, and upgrading to RWMutex for better concurrency control.
Implements deterministic ordering by sorting map keys before iteration across multiple index operations. Adds singleflight pattern to deduplicate concurrent reference lookups and reduce contention. Changes refLock from sync.Mutex to sync.RWMutex to allow concurrent reads
Fixed a bug where parameters were being dropped during YAML rendering. The skip flag wasn't being reset at the start of each slice iteration, causing newly created high-level objects (without low-level models) to be incorrectly skipped.
Fixed a rogue import from an older yaml library. No breaking changes or new features.
Fixed a rogue import from an older yaml library. No breaking changes or new features.
Adds a context aware version of RenderYAMLInline to all objects that support it in the high-level model. Now context is available to be passed down an
Adds a context aware version of RenderYAMLInline to all objects that support it in the high-level model. Now context is available to be passed down and is used to prevent cycles from being detected when running async builds.
No breaking changes.
Adds support for $dynamicRef and $dynamicAnchor across the library.
Adds support for $dynamicRef and $dynamicAnchor across the library.
Address issue #267
Updated test assertions to reflect corrected breaking change counts
Fixing, adding, solving, doing, making.
This PR introduces v0.30 with significant enhancements to the breaking rules system, concurrency improvements in the indexing layer, and API additions for programmatic spec building. The main changes include:
CreateXRef() helper functions for Parameter, Response, RequestBody, PathItem, Header, Link, Callback, and SecuritySchemePropertyCheck creation across 20+ files to use NewPropertyCheck helperDocs updated:
https://pb33f.io/libopenapi/bundling/#advanced-inline-bundling https://pb33f.io/libopenapi/modifying/#using-references https://pb33f.io/libopenapi/what-changed/#configurable-breaking-change-rules
Fixes
Adds additional 3.2 properties that I missed during dev, discovered when testing upstream.
Adds additional 3.2 properties that I missed during dev, discovered when testing upstream.
Docs also available https://pb33f.io/libopenapi/what-changed/#configurable-breaking-change-rules
Configurable Breaking Change Rules
Configurable Breaking Change Rules
New Feature
New Files
Key Capabilities
Refactored Files (35+ model files)
All comparison functions now use configurable lookups instead of hardcoded booleans:
Backward Compatibility
Other Changes
Nothing published for this version
Nothing published for this version
No new features, no breaking changes.
Fixes issue with handling default empty values when rendering out the spec. An issue that was reported in https://github.com/daveshanley/vacuum/issues/725
Now fixed.
No new features, no breaking changes.
Full and complete OpenAPI 3.2 support.
Full and complete OpenAPI 3.2 support.
https://learn.openapis.org/upgrading/v3.1-to-v3.2.html https://github.com/OAI/OpenAPI-Specification/releases/tag/3.2.0
This is a breaking change
Issue #117 has been implemented which means BuildV3Model() will return an error instead of []error as we're now using errors.Join.
Adds error tracking to NodeBuilder to surface issues when rendering
Adds error tracking to NodeBuilder to surface issues when rendering
One column per quarter.