# 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.