1.0.0-beta.95 • Published 3 years ago

@redocly/openapi-cli v1.0.0-beta.95

Install

Weekly downloads

12,886

License

MIT

Repository

Last release

3 years ago

OpenAPI CLI toolset

OpenAPI CLI toolbox with rich validation and bundling features.

Travis (.org) npm (scoped) NPM

OpenAPI 3 CLI toolset

Features

Currently, @redocly/openapi-cli supports these features:

Multifile validation. No need to bundle your file before validation.
Lightning-fast validation. Lint a 1 Mb file in less than one second.
Built-in rules for common validations.
Configurable severity levels for each rule.
Human-readable error messages with codeframes and stylish format options.
Intuitive suggestions for misspelled types or references.
Easy to implement custom rules.
Bundle a multifile definition into a single file.
Decorators to modify a validated definition during bundling.
Preview reference docs for local development.
Support for OpenAPI 2 (fka Swagger) and OpenAPI 3.0.
Support for OpenAPI 3.1 (coming soon).

What makes this tool different

Unlike other OpenAPI linters, @redocly/openapi-cli defines the possible type tree of a valid OpenAPI definition and then traverses it. This approach is very similar to how linters for programming languages work and results in major performance benefits over other approaches. Extend functionality at different points in the lifecycle with preprocessors, rules, and decorators.

TLDR

npx @redocly/openapi-cli lint path-to-root-file.yaml

Read the docs

Credits

Thanks to graphql-js and eslint for inspiration of the definition traversal approach and to Swagger, Spectral, and OAS-Kit for inspiring the ruleset.

6 keywords
11 dependencies
15 dependents
163 versions

linter OpenAPI Swagger OpenAPI linter Swagger linter oas

@redocly/openapi-core @types/node assert-node-version chokidar colorette glob glob-promise handlebars portfinder simple-websocket yargs

unite-us-legacy-api gh-openapi-docs-dev gh-openapi-docs-test @infinitebrahmanuniverse/nolb-_redo @everything-registry/sub-chunk-771 gh-openapi-docs gh-openapi-docs-ts nexumapidoc @chainsafe/bonds-api-client @chainsafe/files-api-client @credify/api-docs @ga4gh/gh-openapi-docs @github/openapi eclipsefdn-api-support @zalastax/nolb-_red

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago