github.com/pb33f/libopenapi

Update hashing performance. No fixes or features, just faster and more performant.

Stop duplicating files referenced from arrays

@mcstepp

Harder, Better, Faster, Stronger

• Rendering Stripe: 77% faster
• Rendering DocuSign (JSON): 87% faster
• Inline-rendering every Stripe schema: 80% faster
• Building JSON specs: 54% to 69% faster
• Across the whole pipeline: 58% less time, 57% less memory, 61% fewer allocations

We forked the YAML library

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.

Two small breaks in the low-level API

• 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.

Bugs, squashed

• Global caches kept dropped documents alive, and could hand a new object a stale hash when a memory address got reused. Both fixed. A document you drop now gets reclaimed without calling ClearAllCaches. (#614, #615)
• A BaseURL without a scheme could crash the whole process during remote lookups. Not anymore. (#578)
• The composed bundler panicked, or left a mangled mapping behind, when a $ref pointed at a sequence or scalar (like root tags). Fixed. (#607, #608)
• what-changed was writing map keys into shared YAML nodes. That was a data race, and it put wrong (and random) keys in reports. Fixed. (#620)
• Swagger 2 headers now map Format, ExclusiveMinimum and UniqueItems correctly. (#630)
• Rendering a document no longer quietly rewrites the tags on your model's enum nodes.

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.

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.

• TypeScript models: Generate type-only modules from component schemas, including interfaces, literal unions, composition, discriminators, nullable types, recursive maps, and component references.
• Go models: Scalar const values in OpenAPI 3.1 oneOf and anyOf schemas now generate typed enums and constants instead of raw JSON unions.

@sloudel

v0.39.1 is a focused performance and correctness release for indexing large OpenAPI documents and generating reliable Go SDK clients.

• Dramatically speeds up indexing of large, minified single-line JSON specs.
• Reduces indexing work by recording each YAML/JSON node only once.
• Generated Go SDKs now reject missing JSON bodies while correctly accepting bodyless responses such as 204 No Content.

@s04

• A new Go SDK generator that produces resource-oriented clients, reachable models, typed responses and API errors, OpenAPI security handling, and optional finite Arazzo workflow methods.
• Full Arazzo 1.1 support, including selectors, typed output values, expanded workflow and action fields, stricter validation, and version-aware runtime expressions.
• Pluggable Arazzo source resolution for OpenAPI, AsyncAPI, and Arazzo documents, with URI origin tracking and no forced network I/O.
• Improved schema and reference handling, including correct source-index attribution for external schemas, document-version resolution, and more reliable inline $ref rendering.
• Better resilience and OpenAPI 3.2 compatibility, including correct additionalOperations metadata and returning a useful error—rather than panicking—when an OpenAPI version field is missing.

@sheidkamp @hdimer @HNO3Miracle

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 daveshanley/vacuum#928

Fixes #597

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

#594

@gnuletik

Bumps to rc6 on yaml and fixed $def handling in bundler.

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, 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

Provides a deeper fix for #575