codegen

Documentation

Index

• type AdditionalPrinterColumn
• type AnyKind
  • func (a *AnyKind) Name() string
  • func (a *AnyKind) Properties() KindProperties
  • func (a *AnyKind) Version(v string) *KindVersion
  • func (a *AnyKind) Versions() []KindVersion
• type AppManifest
• type AppManifestKindPermission
• type AppManifestProperties
• type AppManifestPropertiesExtraPermissions
• type ConversionWebhookProperties
• type Generator
  • func NewGenerator[T any](parser Parser[T], files fs.FS) (*Generator[T], error)
  • func (g *Generator[T]) FilteredGenerate(jennies JennyList[T], filterFunc func(T) bool, selectors ...string) (codejen.Files, error)
  • func (g *Generator[T]) Generate(jennies JennyList[T], selectors ...string) (codejen.Files, error)
• type JennyList
• type Kind
• type KindAdmissionCapability
• type KindAdmissionCapabilityOperation
• type KindCodegenProperties
• type KindProperties
• type KindVersion
• type Parser
• type SimpleManifest
  • func (m *SimpleManifest) Kinds() []Kind
  • func (m *SimpleManifest) Name() string
  • func (m *SimpleManifest) Properties() AppManifestProperties

Types

type AdditionalPrinterColumn

type AdditionalPrinterColumn struct {
	Name        string  `json:"name"`
	Type        string  `json:"type"`
	Format      *string `json:"format,omitempty"`
	Description *string `json:"description,omitempty"`
	Priority    *int32  `json:"priority"`
	JSONPath    string  `json:"jsonPath"`
}

type AnyKind

type AnyKind struct {
	Props       KindProperties
	AllVersions []KindVersion
}

AnyKind is a simple implementation of Kind

func (*AnyKind) Name

func (a *AnyKind) Name() string

func (*AnyKind) Properties

func (a *AnyKind) Properties() KindProperties

func (*AnyKind) Version

func (a *AnyKind) Version(v string) *KindVersion

func (*AnyKind) Versions

func (a *AnyKind) Versions() []KindVersion

type AppManifest

type AppManifest interface {
	Name() string
	Kinds() []Kind
	Properties() AppManifestProperties
}

type AppManifestKindPermission

type AppManifestKindPermission struct {
	Group    string   `json:"group"`
	Resource string   `json:"resource"`
	Actions  []string `json:"actions"`
}

type AppManifestProperties

type AppManifestProperties struct {
	AppName          string                                `json:"appName"`
	Group            string                                `json:"group"`
	FullGroup        string                                `json:"fullGroup"`
	ExtraPermissions AppManifestPropertiesExtraPermissions `json:"extraPermissions"`
}

type AppManifestPropertiesExtraPermissions

type AppManifestPropertiesExtraPermissions struct {
	AccessKinds []AppManifestKindPermission `json:"accessKinds,omitempty"`
}

type ConversionWebhookProperties

type ConversionWebhookProperties struct {
	URL string `json:"url"`
}

type Generator

type Generator[T any] struct {
	// contains filtered or unexported fields
}

func NewGenerator

func NewGenerator[T any](parser Parser[T], files fs.FS) (*Generator[T], error)

func (*Generator[T]) FilteredGenerate

func (g *Generator[T]) FilteredGenerate(jennies JennyList[T], filterFunc func(T) bool, selectors ...string) (codejen.Files, error)

func (*Generator[T]) Generate

func (g *Generator[T]) Generate(jennies JennyList[T], selectors ...string) (codejen.Files, error)

type JennyList

type JennyList[T any] interface {
	Generate(...T) (codejen.Files, error)
}

type Kind

type Kind interface {
	Name() string
	Properties() KindProperties
	Versions() []KindVersion
	Version(version string) *KindVersion
}

Kind is a common interface declaration for code generation. Any type parser should be able to parse a kind into this definition to supply to various common Jennies in the codegen package.

type KindAdmissionCapability

type KindAdmissionCapability struct {
	Operations []KindAdmissionCapabilityOperation `json:"operations"`
}

type KindAdmissionCapabilityOperation

type KindAdmissionCapabilityOperation string

const (
	AdmissionCapabilityOperationCreate  KindAdmissionCapabilityOperation = "CREATE"
	AdmissionCapabilityOperationUpdate  KindAdmissionCapabilityOperation = "UPDATE"
	AdmissionCapabilityOperationDelete  KindAdmissionCapabilityOperation = "DELETE"
	AdmissionCapabilityOperationConnect KindAdmissionCapabilityOperation = "CONNECT"
	AdmissionCapabilityOperationAny     KindAdmissionCapabilityOperation = "*"
)

type KindCodegenProperties

type KindCodegenProperties struct {
	Frontend bool `json:"frontend"`
	Backend  bool `json:"backend"`
}

KindCodegenProperties contains code generation directives for a Kind or KindVersion

type KindProperties

type KindProperties struct {
	// Kind is the unique-within-the-group name of the kind
	Kind string `json:"kind"`
	// Group is the group the Kind is a part of
	Group string `json:"group"`
	// ManifestGroup is the group shortname used by the AppManifest this Kind belongs to
	ManifestGroup string `json:"manifestGroup"`
	// MachineName is the machine version of the Kind, which follows the regex: /^[a-z]+[a-z0-9]*$/
	MachineName string `json:"machineName"`
	// PluralMachineName is the plural of the MachineName
	PluralMachineName string `json:"pluralMachineName"`
	// PluralName is the plural of the Kind
	PluralName string `json:"pluralName"`
	// Current is the version string of the version considered to be "current".
	// This does not have to be the latest, but determines preference when generating code.
	Current                string                      `json:"current"`
	Scope                  string                      `json:"scope"`
	Validation             KindAdmissionCapability     `json:"validation"`
	Mutation               KindAdmissionCapability     `json:"mutation"`
	Conversion             bool                        `json:"conversion"`
	ConversionWebhookProps ConversionWebhookProperties `json:"conversionWebhookProps"`
	// Codegen contains code-generation directives for the codegen pipeline
	Codegen KindCodegenProperties `json:"codegen"`
}

KindProperties is the collection of properties for a Kind which are used for code generation

type KindVersion

type KindVersion struct {
	Version string `json:"version"`
	// Schema is the CUE schema for the version
	// This should eventually be changed to JSONSchema/OpenAPI(/AST?)
	Schema                   cue.Value                 `json:"schema"` // TODO: this should eventually be OpenAPI/JSONSchema (ast or bytes?)
	Codegen                  KindCodegenProperties     `json:"codegen"`
	Served                   bool                      `json:"served"`
	SelectableFields         []string                  `json:"selectableFields"`
	Validation               KindAdmissionCapability   `json:"validation"`
	Mutation                 KindAdmissionCapability   `json:"mutation"`
	AdditionalPrinterColumns []AdditionalPrinterColumn `json:"additionalPrinterColumns"`
}

type Parser

type Parser[T any] interface {
	Parse(fs.FS, ...string) ([]T, error)
}

type SimpleManifest

type SimpleManifest struct {
	Props    AppManifestProperties
	AllKinds []Kind
}

func (*SimpleManifest) Kinds

func (m *SimpleManifest) Kinds() []Kind

func (*SimpleManifest) Name

func (m *SimpleManifest) Name() string

func (*SimpleManifest) Properties

func (m *SimpleManifest) Properties() AppManifestProperties