https://github.com/Mermade/oas-kit

Convert Swagger 2.0 definitions to OpenAPI 3.0 and resolve/validate/lint
https://github.com/Mermade/oas-kit

api conversion converter documentation linter linting openapi openapi-specification openapi3 openapi3-1 swagger validator

Last synced: about 1 month ago
JSON representation

Convert Swagger 2.0 definitions to OpenAPI 3.0 and resolve/validate/lint

• Host: GitHub
• URL: https://github.com/Mermade/oas-kit
• Owner: Mermade
• License: bsd-3-clause
• Created: 2016-10-20T13:17:42.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2023-10-27T07:24:34.000Z (about 1 year ago)
• Last Synced: 2024-04-14T12:36:49.719Z (8 months ago)
• Topics: api, conversion, converter, documentation, linter, linting, openapi, openapi-specification, openapi3, openapi3-1, swagger, validator
• Language: JavaScript
• Homepage: https://mermade.org.uk/openapi-converter
• Size: 4.05 MB
• Stars: 686
• Watchers: 15
• Forks: 129
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - Mermade/oas-kit - Convert Swagger 2.0 definitions to OpenAPI 3.0 and resolve/validate/lint (JavaScript)

README

        
# OAS-Kit

This is the mono-repo for the following related projects

* [swagger2openapi](packages/swagger2openapi/README.md)

* [oas-validator](packages/oas-validator/README.md)

* [oas-linter](packages/oas-linter/README.md)

* [oas-resolver](packages/oas-resolver/README.md)

* [oas-schema-walker](packages/oas-schema-walker/README.md)

* [oas-kit-common](packages/oas-kit-common/README.md)

* [reftools](packages/reftools/README.md)

## Documentation

* [Main site](https://mermade.github.io/oas-kit)

* [CHANGELOG](https://github.com/Mermade/oas-kit/blob/master/CHANGELOG.md#change-log)

## Online converter/validator

* [OpenAPI-webconverter](https://mermade.org.uk/openapi-converter)

## Supported Node.js versions

Any LTS version. It is **not** recommended to use Node.js 12.17.x,12.18.x or 12.19.x due to an [http2 bug](https://github.com/nodejs/node/issues/28001).

## Development

* clone the repository

* `npm i` in the top level directory

* `npx lerna bootstrap`

Please try and keep commits related to a single package or piece of functionality. Please review the

[CONTRIBUTING.md](CONTRIBUTING.md) for additional details.

## Supporting development

* [APIs.guru open-collective](https://opencollective.com/openapi-directory)

* [Linode VPS referral link](https://www.linode.com/?r=5734be467cc501b23267cf66d451bc339042ddfa)