mirror of
https://github.com/k3s-io/kubernetes.git
synced 2025-10-31 05:40:42 +00:00
229 lines
7.9 KiB
Go
229 lines
7.9 KiB
Go
/*
|
|
Copyright 2015 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
// Package generators has the generators for the client-gen utility.
|
|
package generators
|
|
|
|
import (
|
|
"fmt"
|
|
"path/filepath"
|
|
"strings"
|
|
|
|
"k8s.io/gengo/args"
|
|
"k8s.io/gengo/generator"
|
|
"k8s.io/gengo/namer"
|
|
"k8s.io/gengo/types"
|
|
clientgenargs "k8s.io/kubernetes/cmd/libs/go2idl/client-gen/args"
|
|
"k8s.io/kubernetes/cmd/libs/go2idl/client-gen/generators/fake"
|
|
"k8s.io/kubernetes/cmd/libs/go2idl/client-gen/generators/normalization"
|
|
"k8s.io/kubernetes/pkg/api/unversioned"
|
|
|
|
"github.com/golang/glog"
|
|
)
|
|
|
|
// NameSystems returns the name system used by the generators in this package.
|
|
func NameSystems() namer.NameSystems {
|
|
pluralExceptions := map[string]string{
|
|
"Endpoints": "Endpoints",
|
|
}
|
|
return namer.NameSystems{
|
|
"public": namer.NewPublicNamer(0),
|
|
"private": namer.NewPrivateNamer(0),
|
|
"raw": namer.NewRawNamer("", nil),
|
|
"publicPlural": namer.NewPublicPluralNamer(pluralExceptions),
|
|
"privatePlural": namer.NewPrivatePluralNamer(pluralExceptions),
|
|
"allLowercasePlural": namer.NewAllLowercasePluralNamer(pluralExceptions),
|
|
}
|
|
}
|
|
|
|
// DefaultNameSystem returns the default name system for ordering the types to be
|
|
// processed by the generators in this package.
|
|
func DefaultNameSystem() string {
|
|
return "public"
|
|
}
|
|
|
|
func generatedBy(customArgs clientgenargs.Args) string {
|
|
if len(customArgs.CmdArgs) != 0 {
|
|
return fmt.Sprintf("\n// This package is generated by client-gen with arguments: %s\n\n", customArgs.CmdArgs)
|
|
}
|
|
return fmt.Sprintf("\n// This package is generated by client-gen with the default arguments.\n\n")
|
|
}
|
|
|
|
func packageForGroup(gv unversioned.GroupVersion, typeList []*types.Type, packageBasePath string, apiPath string, srcTreePath string, inputPath string, boilerplate []byte, generatedBy string) generator.Package {
|
|
outputPackagePath := filepath.Join(packageBasePath, gv.Group, gv.Version)
|
|
return &generator.DefaultPackage{
|
|
PackageName: gv.Version,
|
|
PackagePath: outputPackagePath,
|
|
HeaderText: boilerplate,
|
|
PackageDocumentation: []byte(
|
|
generatedBy +
|
|
`// This package has the automatically generated typed clients.
|
|
`),
|
|
// GeneratorFunc returns a list of generators. Each generator makes a
|
|
// single file.
|
|
GeneratorFunc: func(c *generator.Context) (generators []generator.Generator) {
|
|
generators = []generator.Generator{
|
|
// Always generate a "doc.go" file.
|
|
generator.DefaultGen{OptionalName: "doc"},
|
|
}
|
|
// Since we want a file per type that we generate a client for, we
|
|
// have to provide a function for this.
|
|
for _, t := range typeList {
|
|
generators = append(generators, &genClientForType{
|
|
DefaultGen: generator.DefaultGen{
|
|
OptionalName: strings.ToLower(c.Namers["private"].Name(t)),
|
|
},
|
|
outputPackage: outputPackagePath,
|
|
group: normalization.BeforeFirstDot(gv.Group),
|
|
version: gv.Version,
|
|
typeToMatch: t,
|
|
imports: generator.NewImportTracker(),
|
|
})
|
|
}
|
|
|
|
generators = append(generators, &genGroup{
|
|
DefaultGen: generator.DefaultGen{
|
|
OptionalName: normalization.BeforeFirstDot(gv.Group) + "_client",
|
|
},
|
|
outputPackage: outputPackagePath,
|
|
inputPacakge: inputPath,
|
|
group: gv.Group,
|
|
version: gv.Version,
|
|
apiPath: apiPath,
|
|
types: typeList,
|
|
imports: generator.NewImportTracker(),
|
|
})
|
|
|
|
expansionFileName := "generated_expansion"
|
|
generators = append(generators, &genExpansion{
|
|
groupPath: filepath.Join(srcTreePath, outputPackagePath),
|
|
DefaultGen: generator.DefaultGen{
|
|
OptionalName: expansionFileName,
|
|
},
|
|
types: typeList,
|
|
})
|
|
|
|
return generators
|
|
},
|
|
FilterFunc: func(c *generator.Context, t *types.Type) bool {
|
|
return extractBoolTagOrDie("genclient", t.SecondClosestCommentLines) == true
|
|
},
|
|
}
|
|
}
|
|
|
|
func packageForClientset(customArgs clientgenargs.Args, typedClientBasePath string, boilerplate []byte, generatedBy string) generator.Package {
|
|
return &generator.DefaultPackage{
|
|
PackageName: customArgs.ClientsetName,
|
|
PackagePath: filepath.Join(customArgs.ClientsetOutputPath, customArgs.ClientsetName),
|
|
HeaderText: boilerplate,
|
|
PackageDocumentation: []byte(
|
|
generatedBy +
|
|
`// This package has the automatically generated clientset.
|
|
`),
|
|
// GeneratorFunc returns a list of generators. Each generator generates a
|
|
// single file.
|
|
GeneratorFunc: func(c *generator.Context) (generators []generator.Generator) {
|
|
generators = []generator.Generator{
|
|
// Always generate a "doc.go" file.
|
|
generator.DefaultGen{OptionalName: "doc"},
|
|
|
|
&genClientset{
|
|
DefaultGen: generator.DefaultGen{
|
|
OptionalName: "clientset",
|
|
},
|
|
groupVersions: customArgs.GroupVersions,
|
|
typedClientPath: typedClientBasePath,
|
|
outputPackage: customArgs.ClientsetName,
|
|
imports: generator.NewImportTracker(),
|
|
},
|
|
}
|
|
return generators
|
|
},
|
|
}
|
|
}
|
|
|
|
// Packages makes the client package definition.
|
|
func Packages(context *generator.Context, arguments *args.GeneratorArgs) generator.Packages {
|
|
boilerplate, err := arguments.LoadGoBoilerplate()
|
|
if err != nil {
|
|
glog.Fatalf("Failed loading boilerplate: %v", err)
|
|
}
|
|
|
|
customArgs, ok := arguments.CustomArgs.(clientgenargs.Args)
|
|
if !ok {
|
|
glog.Fatalf("cannot convert arguments.CustomArgs to clientgenargs.Args")
|
|
}
|
|
includedTypesOverrides := customArgs.IncludedTypesOverrides
|
|
|
|
generatedBy := generatedBy(customArgs)
|
|
|
|
gvToTypes := map[unversioned.GroupVersion][]*types.Type{}
|
|
for gv, inputDir := range customArgs.GroupVersionToInputPath {
|
|
p := context.Universe.Package(inputDir)
|
|
for n, t := range p.Types {
|
|
// filter out types which are not included in user specified overrides.
|
|
typesOverride, ok := includedTypesOverrides[gv]
|
|
if ok {
|
|
found := false
|
|
for _, typeStr := range typesOverride {
|
|
if typeStr == n {
|
|
found = true
|
|
break
|
|
}
|
|
}
|
|
if !found {
|
|
continue
|
|
}
|
|
} else {
|
|
// User has not specified any override for this group version.
|
|
// filter out types which dont have genclient=true.
|
|
if extractBoolTagOrDie("genclient", t.SecondClosestCommentLines) == false {
|
|
continue
|
|
}
|
|
}
|
|
if _, found := gvToTypes[gv]; !found {
|
|
gvToTypes[gv] = []*types.Type{}
|
|
}
|
|
gvToTypes[gv] = append(gvToTypes[gv], t)
|
|
}
|
|
}
|
|
|
|
var packageList []generator.Package
|
|
typedClientBasePath := filepath.Join(customArgs.ClientsetOutputPath, customArgs.ClientsetName, "typed")
|
|
|
|
packageList = append(packageList, packageForClientset(customArgs, typedClientBasePath, boilerplate, generatedBy))
|
|
if customArgs.FakeClient {
|
|
packageList = append(packageList, fake.PackageForClientset(customArgs, typedClientBasePath, boilerplate, generatedBy))
|
|
}
|
|
|
|
// If --clientset-only=true, we don't regenerate the individual typed clients.
|
|
if customArgs.ClientsetOnly {
|
|
return generator.Packages(packageList)
|
|
}
|
|
|
|
orderer := namer.Orderer{Namer: namer.NewPrivateNamer(0)}
|
|
for _, gv := range customArgs.GroupVersions {
|
|
types := gvToTypes[gv]
|
|
inputPath := customArgs.GroupVersionToInputPath[gv]
|
|
packageList = append(packageList, packageForGroup(normalization.GroupVersion(gv), orderer.OrderTypes(types), typedClientBasePath, customArgs.ClientsetAPIPath, arguments.OutputBase, inputPath, boilerplate, generatedBy))
|
|
if customArgs.FakeClient {
|
|
packageList = append(packageList, fake.PackageForGroup(normalization.GroupVersion(gv), orderer.OrderTypes(types), typedClientBasePath, arguments.OutputBase, inputPath, boilerplate, generatedBy))
|
|
}
|
|
}
|
|
|
|
return generator.Packages(packageList)
|
|
}
|