https://github.com/whitlockjc/oval

oval: CLI for (O)penAPI Specification document (val)idation.
https://github.com/whitlockjc/oval

cli javascript nodejs openapi swagger

Last synced: about 1 month ago
JSON representation

oval: CLI for (O)penAPI Specification document (val)idation.

• Host: GitHub
• URL: https://github.com/whitlockjc/oval
• Owner: whitlockjc
• License: mit
• Created: 2018-07-18T18:51:02.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-08-06T20:52:13.000Z (4 months ago)
• Last Synced: 2025-09-18T00:57:37.734Z (2 months ago)
• Topics: cli, javascript, nodejs, openapi, swagger
• Language: JavaScript
• Homepage:
• Size: 62.5 KB
• Stars: 14
• Watchers: 1
• Forks: 2
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
oval

====

oval: CLI for (O)penAPI Specification document (val)idation

[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)

[![Version](https://img.shields.io/npm/v/oval.svg)](https://npmjs.org/package/oval)

[![TravisCI](https://travis-ci.org/whitlockjc/oval.svg?branch=master)](https://travis-ci.org/whitlockjc/oval)

[![Codecov](https://codecov.io/gh/whitlockjc/oval/branch/master/graph/badge.svg)](https://codecov.io/gh/whitlockjc/oval)

[![Downloads/week](https://img.shields.io/npm/dw/oval.svg)](https://npmjs.org/package/oval)

[![License](https://img.shields.io/npm/l/oval.svg)](https://github.com/whitlockjc/oval/blob/master/package.json)

# Overview

`oval` is an OpenAPI Specification _(OAS)_ document validator that was built to replace the CLI provided by

[swagger-tools](https://github.com/apigee-127/swagger-tools).  `oval` is built on top of

[sway](https://github.com/apigee-127/sway), the successor to the API portion of `swagger-tools`, which provides

extremely thorough OAS validation.  Plans for `oval` are to provide an [eslint](https://eslint.org/)-like experience for

OAS validation in the future.

Currently Oval supports OpenAPI v2.

* [Usage](#usage)

* [Commands](#commands)

# Usage

```sh-session

$ npm install -g oval

$ oval COMMAND

running command...

$ oval (-v|--version|version)

oval/1.0.0 darwin-x64 node-v8.3.0

$ oval --help [COMMAND]

USAGE

  $ oval COMMAND

...

```

# Commands

* [`oval help [COMMAND]`](#oval-help-command)

* [`oval validate LOCATION`](#oval-validate-location)

## `oval help [COMMAND]`

display help for oval

```

USAGE

  $ oval help [COMMAND]

ARGUMENTS

  COMMAND  command to show help for

OPTIONS

  --all  see all commands in CLI

```

_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v2.0.5/src/commands/help.ts)_

## `oval validate LOCATION`

validate an OpenAPI Specification (OAS) document

```

USAGE

  $ oval validate LOCATION

ARGUMENTS

  LOCATION  The path/URL to the OAS document being validated

OPTIONS

  -N, --no-color            turn off colored output

  -j, --json                output results as JSON

  -p, --print-success       print message for success

  -w, --warnings-as-errors  treat warnings as errors

```

_See code: [lib/commands/validate.js](https://github.com/whitlockjc/oval/blob/v1.0.0/lib/commands/validate.js)_