Skip to content

Releases: speakeasy-api/openapi

v1.7.8

07 Oct 03:06

Choose a tag to compare

Changes

  • Add YAMLToJSONCompatibleGoType function to convert YAML nodes to JSON-compatible Go types
  • Add comprehensive test coverage for json package functions
  • Fix YAML merge key handling to properly merge referenced maps
  • Update mise test task to support package-specific test execution

Bug Fixes

  • YAML merge keys are now properly handled, merging referenced map values instead of treating merge key as a literal key

Testing

  • Added 34 new tests with full coverage of YAML-to-JSON conversion scenarios
  • All tests follow project conventions with parallel execution and testify assertions

OpenAPI CLI v1.7.8

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • a30e6a1 fix(json): add YAMLToJSONCompatibleGoType, tests, and fix YAML merge keys

Full Changelog: v1.7.7...v1.7.8

Released by GoReleaser.

v1.7.7

03 Oct 07:28

Choose a tag to compare

Full Changelog: v1.7.6...v1.7.7

OpenAPI CLI v1.7.7

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 903dfce fix: fixed issues with navigating with jsonpointers through unknown properties

Full Changelog: v1.7.6...v1.7.7

Released by GoReleaser.

v1.7.6

03 Oct 02:45

Choose a tag to compare

Full Changelog: v1.7.5...v1.7.6

OpenAPI CLI v1.7.6

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog


Full Changelog: v1.7.5...v1.7.6

Released by GoReleaser.

v1.7.5

01 Oct 09:10

Choose a tag to compare

Full Changelog: v1.7.4...v1.7.5

OpenAPI CLI v1.7.5

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 34d01b0 fix: improved handling of type validation errors and their message content

Full Changelog: v1.7.4...v1.7.5

Released by GoReleaser.

v1.7.4

30 Sep 03:55
d2f8ee3

Choose a tag to compare

What's Changed

Bug Fixes

  • Improved EitherValue error handling - Enhanced unmarshalling and validation error messages for EitherValue types to make it easier to identify the root cause of failures (#55)
    • Enhanced error context in unmarshalling to provide clearer information about which type alternatives failed
    • Improved validation error formatting to better indicate the source of validation failures
    • Updated unmarshaller logic to capture and report more detailed error information
    • Added comprehensive test coverage for edge cases

This release improves the developer experience when working with EitherValue types by making validation errors more actionable and easier to debug.

Full Changelog: v1.7.3...v1.7.4

OpenAPI CLI v1.7.4

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 3e915b0 fix(deps): bump github.com/testcontainers/testcontainers-go (#53)
  • d2f8ee3 fix: improved unmarshalling and validation errors of eithervalues (#55)

Full Changelog: v1.7.3...v1.7.4

Released by GoReleaser.

v1.7.3

19 Sep 07:03
bbff202

Choose a tag to compare

Bug Fixes

OpenAPI Bundle Parent Directory Reference Handling

  • Fixed: Resolve parent directory references in OpenAPI bundle to meaningful component names
  • Improved: Path resolution for relative paths like now generates readable component names
  • Enhanced: Error handling in bundle functionality with proper error propagation

Changes

  • Before: →
  • After: →

Technical Details

  • Added function using , , and
  • Enhanced error handling in and related functions
  • Improved path resolution for parent directory references
  • Added comprehensive test cases to prevent regressions

This release makes bundled OpenAPI documents more readable and addresses issues with relative path references in the bundle functionality.

Full Changelog: v1.7.2...v1.7.3

OpenAPI CLI v1.7.3

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • bbff202 fix: resolve parent directory references in OpenAPI bundle to meaningful component names (#51)

Full Changelog: v1.7.2...v1.7.3

Released by GoReleaser.

v1.7.2

19 Sep 06:11
e3920da

Choose a tag to compare

What's Changed

  • fix: support OpenAPI 3.0 boolean exclusiveMinimum/exclusiveMaximum validation by @TristanSpeakEasy in #52

Full Changelog: v1.7.1...v1.7.2

OpenAPI CLI v1.7.2

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • e3920da fix: support OpenAPI 3.0 boolean exclusiveMinimum/exclusiveMaximum validation (#52)

Full Changelog: v1.7.1...v1.7.2

Released by GoReleaser.

v1.7.1

17 Sep 02:21
ca028d0

Choose a tag to compare

Bug Fixes

  • Localize: Fixed remote reference handling to ensure consistent file system usage during localization process
  • References: Improved reference resolution reliability when working with remote references

Enhancements

  • Walk Operations: Exposed utility methods for extracting HTTP method and path information during OpenAPI operation traversal
  • Public API: Enhanced developer experience with better access to operation metadata

Changes

  • Fixed issue where Localize method was not using the same file system for both resolution and writing of localized files
  • Exposed utility methods in openapi/utils.go for better operation walking functionality
  • Updated tests and maintained backward compatibility

Files Modified

  • jsonschema/oas3/resolution.go - Reference resolution improvements
  • openapi/cmd/localize.go - Localize command updates
  • openapi/localize.go - Core localization logic fixes
  • openapi/localize_test.go - Updated tests for localization
  • openapi/reference.go - Reference handling improvements
  • openapi/utils.go - Exposed utility methods
  • openapi/walk_operations_test.go - Tests for walk utilities

This release improves reliability of remote reference localization and enhances the developer experience with better utility access while maintaining full backward compatibility.

OpenAPI CLI v1.7.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • ca028d0 fix: improve localize remote reference handling and expose walk utilities (#49)

Full Changelog: v1.7.0...v1.7.1

Released by GoReleaser.

v1.7.0

16 Sep 22:15
192fe7c

Choose a tag to compare

🚀 New Features

OpenAPI Document Localization

  • New command: Converts external references in OpenAPI documents to local file references
  • Flexible naming strategies: Support for counter-based and path-based file naming
  • Comprehensive reference handling: Processes all types of OpenAPI references including schemas, responses, parameters, and more
  • Robust file management: Handles duplicate filenames and maintains reference integrity

📊 Changes

  • Added 2,387 lines of new functionality
  • New CLI command: openapi localize
  • Enhanced filesystem utilities
  • Comprehensive test coverage with multiple test scenarios

🔗 Full Changelog

Full Changelog: v1.6.5...v1.7.0

This release significantly enhances the OpenAPI toolkit by providing powerful document localization capabilities, making it easier to work with distributed OpenAPI specifications.

OpenAPI CLI v1.7.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

  • 192fe7c feat: add OpenAPI document localization functionality and CLI command (#48)

Full Changelog: v1.6.5...v1.7.0

Released by GoReleaser.

v1.6.5

11 Sep 01:22
4b5b9fa

Choose a tag to compare

Bug Fixes

  • marshaller: Fix handling of empty objects during marshaller sync that was impacting docs upgrading with nullable only schemas (#47)

What's Changed

  • Fixes panic during OpenAPI 3.0 to 3.1 upgrades when processing schemas with nullable: true properties
  • Ensures empty schemas are properly represented as {} instead of causing nil pointer panics
  • Maintains backward compatibility while properly converting nullable schemas to OpenAPI 3.1 format

Full Changelog: v1.6.4...v1.6.5

OpenAPI CLI v1.6.5

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 4b5b9fa fix: fixes handling of empty objects during marshaller sync that was impacting docs upgrading with nullable only schemas (#47)

Full Changelog: v1.6.4...v1.6.5

Released by GoReleaser.