mirror of
https://github.com/ceph/ceph-csi.git
synced 2024-12-22 21:10:22 +00:00
24 lines
941 B
Markdown
24 lines
941 B
Markdown
|
# gnostic-analyze
|
||
|
|
|
||
|
|
This directory contains a `gnostic` plugin that analyzes an OpenAPI description for factors
|
||
|
|
that might influence code generation and other API automation.
|
||
|
|
|
||
|
|
The plugin can be invoked like this:
|
||
|
|
|
||
|
|
gnostic bookstore.json --analyze_out=.
|
||
|
|
|
||
|
|
This will write analysis results to a file in the current directory.
|
||
|
|
Results are written to a file named `summary.json`.
|
||
|
|
|
||
|
|
The plugin can be applied to a directory of descriptions using a command
|
||
|
|
like the following:
|
||
|
|
|
||
|
|
find APIs -name "swagger.yaml" -exec gnostic --analyze_out=analysis {} \;
|
||
|
|
|
||
|
|
This finds all `swagger.yaml` files in a directory named `APIs` and its subdirectories
|
||
|
|
and writes corresponding `summary.json` files into a directory named `analysis`.
|
||
|
|
|
||
|
|
Results of multiple analysis runs can be gathered together and summarized
|
||
|
|
using the `summarize` program, which is in the `summarize` subdirectory.
|
||
|
|
Just run `summarize` in the same location as the `find` command shown above.
|