Swagger Avocado

Overview

Check "Swagger Avocado" is a thin wrapper around package @azure/avocado, which is hosted in its own repo and published to npmjs.

Repo: https://github.com/Azure/avocado

Package: https://www.npmjs.com/package/@azure/avocado

Fixing Errors

https://github.com/Azure/avocado?tab=readme-ov-file#how-to-solve-errors

Running Locally

$ cd azure-rest-api-specs
$ npm ci
$ npx avocado --excludePaths common-types -d specification/contosowidgetmanager

Known Issues

Workaround is for PR reviewer to apply label Approved-Avocado until tool issues are fixed.

1. Allow specs with readme.md in sub-folders under resource-manager
2. Fails on "missing APIs in default tag" even if they have been deprecated and/or removed

Future Plans

• Move code for check and package to specs repo (https://github.com/Azure/azure-rest-api-specs/issues/32398)