README
¶
Kube OpenAPI
This repo is the home for Kubernetes OpenAPI discovery spec generation. The goal is to support a subset of OpenAPI features to satisfy kubernetes use-cases but implement that subset with little to no assumption about the structure of the code or routes. Thus, there should be no kubernetes specific code in this repo.
There are two main parts:
- A model generator that goes through .go files, find and generate model definitions.
- The spec generator that is responsible for dynamically generate the final OpenAPI spec using web service routes or combining other OpenAPI/Json specs.
Directories
¶
| Path | Synopsis |
|---|---|
|
example
|
|
|
openapi-gen
This package generates openAPI definition file to be used in open API spec generation on API servers.
|
This package generates openAPI definition file to be used in open API spec generation on API servers. |
|
pkg
|
|
|
builder
Package builder contains code to generate OpenAPI discovery spec (which initial version of it also known as Swagger 2.0).
|
Package builder contains code to generate OpenAPI discovery spec (which initial version of it also known as Swagger 2.0). |
|
common
package common holds shared code and types between open API code generator and spec generator.
|
package common holds shared code and types between open API code generator and spec generator. |
|
util/proto
Package proto is a collection of libraries for parsing and indexing the type definitions.
|
Package proto is a collection of libraries for parsing and indexing the type definitions. |
Click to show internal directories.
Click to hide internal directories.