Also update: - kubernetes to v1.9.0 - k8s.io/api, k8s.io/apimachinery, k8s.io/code-generator to kubernetes-1.9.0 - gengo to b58fc7edb82e0c6ffc9b8aef61813c7261b785d4 (to match code-generator) Signed-off-by: Andy Goldstein <andy.goldstein@gmail.com> |
||
---|---|---|
.. | ||
args | ||
examples | ||
generator | ||
namer | ||
parser | ||
types | ||
.import-restrictions | ||
LICENSE | ||
OWNERS | ||
README.md | ||
code-of-conduct.md |
README.md
gengo
A package for generating things based on go files. This mechanism was first used in Kubernetes and is split out here for ease of reuse and maintainability.
go get k8s.io/gengo
Examples
A set generator, deep-copy generator, defaulter generator and go-to-protobuf generator are included here. Also, import-boss will enforce arbitrary rules about import trees.
args/
Package args defines common arguments for a generator binary.
generator/
Package generator defines interfaces for code generators to implement, and machinery that will execute those code generators.
types/
Package types contains the type system definition. It is modeled after Go's type system, but it's intended that you could produce these types by parsing something else, if you want to write the parser/converter.
We don't directly use the go types in the go typecheck library because they are based on implementing differing interfaces. A struct-based format is more convenient input for template driven output.
parser/
Package parser parses go source files.
namer/
Package namer defines a naming system, for:
- helping you reference go objects in a syntactically correct way
- keeping track of what you reference, for importing the right packages
- and defining parallel tracks of names, for making public interfaces and private implementations.