idl

package
v0.0.0-...-d3ccc4f Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 11, 2018 License: Apache-2.0, Apache-2.0 Imports: 0 Imported by: 0

Documentation

Overview

The IDL package describes comment directives that may be applied to API types and fields.

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ListMapKey

type ListMapKey string

ListMapKey annotates map lists by specifying the key used as the index of the map.

This tag MUST only be used on lists that have the listType=map attribute, or the generation step will fail. Also, the value specified for this attribute must be a scalar typed field of the child structure (no nesting is supported).

An example of how this can be used is shown in the ListType (map) example.

Example:

+listMapKey=name

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-list-map-key": "name"

type ListType

type ListType string

ListType annotates a list to further describe its topology. It may have 3 possible values: "atomic", "map", or "set". Note that there is no default, and the generation step will fail if a list is found that is missing the tag.

This tag MUST only be used on lists, or the generation step will fail.

Atomic

Example:

+listType=atomic

Atomic lists will be entirely replaced when updated. This tag may be used on any type of list (struct, scalar, ...).

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-list-type": "atomic"

Map

Example:

+listType=map

These lists are like maps in that their elements have a non-index key used to identify them. Order is preserved upon merge. Using the map tag on a list with non-struct elements will result in an error during the generation step.

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-list-type": "map"

Set

Example:

+listType=set

Sets are lists that must not have multiple times the same value. Each value must be a scalar (or another atomic type).

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-list-type": "set"
Example (Atomic)

This example shows how to use the listType atomic attribute to specify that this list should be treated as a whole.

package main

import ()

func main() {
	type SomeStruct struct {
		Name  string
		Value string
	}

	type SomeAPI struct {
		// +listType=atomic
		elements []SomeStruct
	}
}
Output:

Example (Map)

This example shows how to use the listType map attribute and how to specify a key to identify elements of the list. The listMapKey attribute is used to specify that Name is the key of the map.

package main

import ()

func main() {
	type SomeStruct struct {
		Name  string
		Value string
	}
	type SomeAPI struct {
		// +listType=map
		// +listMapKey=name
		elements []SomeStruct
	}
}
Output:

Example (Set)

This example shows how to use the listType set attribute to specify that this list should be treated as a set: items in the list can't be duplicated.

package main

import ()

func main() {
	type SomeAPI struct {
		// +listType=set
		keys []string
	}
}
Output:

type MapType

type MapType string

MapType annotates a map to further describe its topology. It may have only one value: "atomic". Atomic means that the entire map is considered as a whole, rather than as distinct values.

By default, a map will be considered as a set of distinct values that can be updated individually. This default WILL NOT generate any openapi extension, as this will also be interpreted as the default behavior in the openapi definition.

This tag MUST only be used on maps, or the generation step will fail.

Atomic

Example:

+mapType=atomic

Atomic maps will be entirely replaced when updated. This tag may be used on any map.

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-map-type": "atomic"
Example (Atomic)

This example shows how to use the mapType atomic attribute to specify that this map should be treated as a whole.

package main

import ()

func main() {
	type SomeAPI struct {
		// +mapType=atomic
		elements map[string]string
	}
}
Output:

type OpenAPIGen

type OpenAPIGen string

OpenAPIGen needs to be described.

type Optional

type Optional string

Optional needs to be described.

type PatchMergeKey

type PatchMergeKey string

PatchMergeKey needs to be described.

type PatchStrategy

type PatchStrategy string

PatchStrategy needs to be described.

type StructType

type StructType string

StructType annotates a struct to further describe its topology. It may have only one value: "atomic". Atomic means that the entire struct is considered as a whole, rather than as distinct values.

By default, a struct will be considered as a set of distinct values that can be updated individually. This default WILL NOT generate any openapi extension, as this will also be interpreted as the default behavior in the openapi definition.

This tag MUST only be used on structs, or the generation step will fail.

Atomic

Example:

+structType=atomic

Atomic structs will be entirely replaced when updated. This tag may be used on any struct.

Using this tag will generate the following OpenAPI extension:

"x-kubernetes-struct-type": "atomic"
Example (Atomic)

This example shows how to use the structType atomic attribute to specify that this struct should be treated as a whole.

package main

import ()

func main() {
	type SomeStruct struct {
		Name  string
		Value string
	}
	type SomeAPI struct {
		// +structType=atomic
		elements SomeStruct
	}
}
Output:

type Union

type Union string

Union is TBD.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL