https://github.com/speakeasy-api/openapi

A set of packages and tools for working with OpenAPI and Arazzo Specification documents.
https://github.com/speakeasy-api/openapi

arazzo golang openapi

Last synced: 3 months ago
JSON representation

A set of packages and tools for working with OpenAPI and Arazzo Specification documents.

• Host: GitHub
• URL: https://github.com/speakeasy-api/openapi
• Owner: speakeasy-api
• License: mit
• Created: 2024-08-22T08:59:55.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-30T05:10:58.000Z (3 months ago)
• Last Synced: 2025-07-22T02:04:00.575Z (3 months ago)
• Topics: arazzo, golang, openapi
• Language: Go
• Homepage:
• Size: 339 KB
• Stars: 19
• Watchers: 6
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          


 

   

       

       

       

   

 

  
Speakeasy

  
Build APIs your users love ❤️ with Speakeasy

  


   Docs Quickstart  //  Join us on Slack

  

 








  


    

  

  
OpenAPI

  
A set of packages and tools for working with OpenAPI Specification documents. 
 Used directly in Speakeasy's product to power our SDK Generator and Contract Testing tools.



  


    

    

    

   


    

    

    

  


## Main Packages

### [arazzo](./arazzo)

The `arazzo` package provides an API for working with Arazzo documents including reading, creating, mutating, walking and validating them.

## Sub Packages

This repository also contains a number of sub packages that are used by the main packages to provide the required functionality. The below packages may be moved into their own repository in the future, depending on future needs.

### [json](./json)

The `json` package provides utilities for converting between JSON and YAML.

### [jsonpointer](./jsonpointer)

The `jsonpointer` package provides an API for working with [RFC 6901](https://datatracker.ietf.org/doc/html/rfc6901) compliant JSON Pointers. Providing functionality for validating JSON Pointers, and extracting the target of a JSON Pointer for various Go types and structures.

### [jsonschema](./jsonschema)

The `jsonschema` package provides various models for working with the different JSON Schema dialects.

### [sequencedmap](./sequencedmap)

The `sequencedmap` package provides a map implementation that maintains the order of keys as they are added.

## Contributing

This repository is maintained by Speakeasy, but we welcome and encourage contributions from the community to help improve its capabilities and stability.

### How to Contribute

1. **Open Issues**: Found a bug or have a feature suggestion? Open an issue to describe what you'd like to see changed.

2. **Pull Requests**: We welcome pull requests! If you'd like to contribute code:

   - Fork the repository

   - Create a new branch for your feature/fix

   - Submit a PR with a clear description of the changes and any related issues

3. **Feedback**: Share your experience using the packages or suggest improvements.

All contributions, whether they're bug reports, feature requests, or code changes, help make this project better for everyone.

Please ensure your contributions adhere to our coding standards and include appropriate tests where applicable.