k8s.io/code-generator

⚠️ This is an automatically published staged repository for Kubernetes.
Contributions, including issues and pull requests, should be made to the main Kubernetes repository: https://github.com/kubernetes/kubernetes.
This repository is read-only for importing, and not used for direct contributions.
See CONTRIBUTING.md for more details.

code-generator

Golang code-generators used to implement Kubernetes-style API types.

Purpose

These code-generators can be used

• in the context of CustomResourceDefinition to build native, versioned clients, informers and other helpers
• in the context of User-provider API Servers to build conversions between internal and versioned types, defaulters, protobuf codecs, internal and versioned clients and informers.

Resources

• The example sample controller shows a code example of a controller that uses the clients, listers and informers generated by this library.
• The article Kubernetes Deep Dive: Code Generation for CustomResources gives a step by step instruction on how to use this library.

Usage

The examples above are dated. The current recommended script to use is kube_codegen.sh.

Compatibility

HEAD of this repo will match HEAD of k8s.io/apiserver, k8s.io/apimachinery, and k8s.io/client-go.

Where does it come from?

code-generator is synced from https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/code-generator. Code changes are made in that location, merged into k8s.io/kubernetes and later synced here.