roas-cli-0.1.0 is not a library.

roas-cli

Command-line front-end for roas: validate and convert OpenAPI specs across versions 2.0 / 3.0.x / 3.1.x / 3.2.x.

Install

cargo install roas-cli

The installed binary is named roas.

Usage

roas validate <FILE>            # parse + validate
roas convert --to v3_2 <FILE>   # upconvert across versions

Input can be JSON or YAML; the parser is selected by file extension (.yaml / .yml → YAML, everything else → JSON).

`validate`

Auto-detects the spec version from the openapi / swagger field; pass --from to force. External $refs are skipped by default; opt in with --load:

roas validate spec.yaml                   # local refs only
roas validate --load file spec.yaml       # follow `file://` $refs
roas validate --load http spec.yaml       # follow `http(s)://` $refs
roas validate --load file --load http spec.yaml  # both

--ignore <CHECK> skips a specific validation check; repeat the flag to skip more than one. The list is sourced from roas::validation::Options (via roas's clap feature), so it stays in sync with the library:

missing-tags, external-references, invalid-urls, non-uniq-operation-ids,
unused-path-items, unused-tags, unused-schemas, unused-parameters,
unused-responses, unused-server-variables, unused-examples,
unused-request-bodies, unused-headers, unused-security-schemes,
unused-links, unused-callbacks, unused-media-types,
empty-info-title, empty-info-version, empty-response-description,
empty-external-documentation-url

Run roas validate --help for descriptions of each check.

`convert`

Upconverts a spec to a target version by chaining the existing From<v_X::Spec> for v_Y::Spec migrations. Downconversion is not supported.

roas convert --to v3_2 spec.json
roas convert --to v3_1 --from v2 spec.yaml

Output is JSON on stdout.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

roas-cli 0.1.0