Skip to content

v1.0.0

Choose a tag to compare

@alissonsleal alissonsleal released this 29 Apr 20:29
· 4 commits to main since this release

Full Changelog: https://github.com/alissonsleal/openapi-splitter/commits/v1.0.0

OpenAPI Splitter v1.0.0 Release

I'm excited to announce the first official release of OpenAPI Splitter, a command-line tool designed to split large OpenAPI 3.0 specification files into multiple organized files and folders, making them more maintainable and easier to work with.

🎉 What's in this initial release

  • Full support for splitting OpenAPI 3.0 specifications into organized directory structures
  • Path splitting with proper normalization for valid filenames
  • Component extraction for schemas, parameters, responses, and tags
  • Auto-generated index files for component collections
  • Support for both JSON and YAML formats with conversion capabilities
  • Proper reference management across all split files
  • Debug mode for troubleshooting

🚀 How to use

The tool can be used without installation:

npx openapi-splitter <file> [options]

Or installed globally:

npm install -g openapi-splitter
openapi-splitter <file> [options]

For more detailed usage instructions and examples, please refer to the README.

📋 Future plans

  • Support for OpenAPI 3.1
  • Enhanced customization options
  • Additional optimization features
  • Interactive mode

Thank you to everyone who provided feedback during the development process! We look forward to your feedback and contributions to make OpenAPI Splitter even better.