kubespec

type APISpec ¶

type APISpec struct {
	SwaggerVersion string            `json:"swagger"`
	Info           *SchemaInfo       `json:"info"`
	Definitions    SchemaDefinitions `json:"definitions"`

	// Not part of the OpenAPI spec. Filled in later.
	FilePath string
	Text     []byte
}

APISpec represents an OpenAPI specification of an API.

type DefinitionName ¶

type DefinitionName string

DefinitionName represents the name of a definition. For example, `v1.APIGroup`.

func (dn DefinitionName) AsObjectRef() *ObjectRef

func (dn *DefinitionName) Parse() (*ParsedDefinitionName, error)

func (dn DefinitionName) String() string

type GroupName ¶

type GroupName string

GroupName represetents a Kubernetes group name (e.g., apps, extensions, etc.)

func (gn GroupName) String() string

type Items ¶

type Items struct {
	Ref *ObjectRef `json:"$ref"`
}

Items represents the type of an element in an array. Usually this is used to fully specify a `Property` object whose `type` field is `"array"`.

type ObjectKind ¶

type ObjectKind string

ObjectKind represents the `kind` of a Kubernetes API object (e.g., Service, Deployment, etc.)

func (ok ObjectKind) String() string

type ObjectRef ¶

type ObjectRef string

ObjectRef represents a reference to some API object. For example, `#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta`

func (or *ObjectRef) IsMixinRef() bool

func (or *ObjectRef) Name() *DefinitionName

func (or ObjectRef) String() string

type Package ¶

type Package int

Package represents the type of the definition, either `APIs`, which have API groups (e.g., extensions, apps, meta, and so on), or `Core`, which does not.

const (
	// Core is a package that contains the Kubernetes Core objects.
	Core Package = iota

	// APIs is a set of non-core packages grouped loosely by semantic
	// functionality (e.g., apps, extensions, and so on).
	APIs

	// Util is a package that contains utilities used for both testing
	// and running Kubernetes.
	Util

	// Runtime is a package that contains various utilities used in the
	// Kubernetes runtime.
	Runtime

	// Version is a package that supplies version information collected
	// at build time.
	Version
)

type ParsedDefinitionName ¶

type ParsedDefinitionName struct {
	PackageType Package
	Codebase    string
	Group       *GroupName     // Pointer because it's optional.
	Version     *VersionString // Pointer because it's optional.
	Kind        ObjectKind
}

ParsedDefinitionName is a parsed version of a fully-qualified OpenAPI spec name. For example, `io.k8s.kubernetes.pkg.api.v1.Container` would parse into an instance of the struct below.

func (p *ParsedDefinitionName) Unparse(isLegacySchema bool) (DefinitionName, error)

type Properties ¶

type Properties map[PropertyName]*Property

Properties is a named collection of `Properties`s, represented as a collection mapping definition name -> `Properties`.

type Property ¶

type Property struct {
	Description string      `json:"description"`
	Type        *SchemaType `json:"type"`
	Ref         *ObjectRef  `json:"$ref"`
	Items       Items       `json:"items"` // nil unless Type == "array".
}

Property represents an object property for some API object. For example, `v1.APIGroup` might contain a property called `apiVersion`, which would be specifid by a `Property`.

type PropertyName ¶

type PropertyName string

PropertyName represents the name of a property. For example, `apiVersion` or `kind`.

func (pn PropertyName) String() string

type SchemaDefinition ¶

type SchemaDefinition struct {
	Type          *SchemaType   `json:"type"`
	Description   string        `json:"description"` // nullable.
	Required      []string      `json:"required"`    // nullable.
	Properties    Properties    `json:"properties"`  // nullable.
	TopLevelSpecs TopLevelSpecs `json:"x-kubernetes-group-version-kind"`
	Ref           string        `json:"$ref,omitempty"`
}

SchemaDefinition is an API object definition. For example, this might contain a name (e.g., `v1.APIGroup`), a set of properties (e.g., `apiVersion`, `kind`, and so on), and the names of required properties.

func (sd *SchemaDefinition) IsCRD() bool

func (sd *SchemaDefinition) IsDeprecated() bool

func (sd *SchemaDefinition) QualifiedGroupName(groupName string) string

type SchemaDefinitions ¶

type SchemaDefinitions map[DefinitionName]*SchemaDefinition

SchemaDefinitions is a named collection of `SchemaDefinition`s, represented as a collection mapping definition name -> `SchemaDefinition`.

type SchemaInfo ¶

type SchemaInfo struct {
	Title   string `json:"title"`
	Version string `json:"version"`
}

SchemaInfo contains information about the the API represented with `APISpec`. For example, `title` might be `"Kubernetes"`, and `version` might be `"v1.7.0"`.

type SchemaType ¶

type SchemaType string

SchemaType represents the type of some object in an API spec. For example, a property might have type `string`.

func (st SchemaType) String() string

type TopLevelSpec ¶

type TopLevelSpec struct {
	Group   GroupName     `json:"Group"`
	Version VersionString `json:"Version"`
	Kind    ObjectKind    `json:"Kind"`
}

TopLevelSpec is a property that exists on `SchemaDefinition`s for top-level API objects.

type TopLevelSpecs ¶

type TopLevelSpecs []*TopLevelSpec

type VersionString ¶

type VersionString string

VersionString is the string representation of an API version (e.g., v1, v1beta1, etc.)

func (vs VersionString) String() string