Bumping k8s dependencies to 1.13

vendor/k8s.io/kube-openapi/pkg/idl/doc.go

@@ -0,0 +1,140 @@
+/*
+Copyright 2018 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.
+*/
+
+// The IDL package describes comment directives that may be applied to
+// API types and fields.
+package idl
+
+// 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"
+type ListType 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 ListMapKey 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"
+type MapType string
+
+// OpenAPIGen needs to be described.
+type OpenAPIGen string
+
+// Optional needs to be described.
+type Optional string
+
+// PatchMergeKey needs to be described.
+type PatchMergeKey string
+
+// PatchStrategy needs to be described.
+type PatchStrategy 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"
+type StructType string
+
+// Union is TBD.
+type Union string

vendor/k8s.io/kube-openapi/pkg/idl/listtype_test.go

@@ -0,0 +1,56 @@
+/*
+Copyright 2018 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 idl_test
+
+// 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.
+func ExampleListType_map() {
+	type SomeStruct struct {
+		Name  string
+		Value string
+	}
+	type SomeAPI struct {
+		// +listType=map
+		// +listMapKey=name
+		elements []SomeStruct
+	}
+}
+
+// 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.
+func ExampleListType_set() {
+	type SomeAPI struct {
+		// +listType=set
+		keys []string
+	}
+}
+
+// This example shows how to use the listType atomic attribute to
+// specify that this list should be treated as a whole.
+func ExampleListType_atomic() {
+	type SomeStruct struct {
+		Name  string
+		Value string
+	}
+
+	type SomeAPI struct {
+		// +listType=atomic
+		elements []SomeStruct
+	}
+}

vendor/k8s.io/kube-openapi/pkg/idl/maptype_test.go

@@ -0,0 +1,26 @@
+/*
+Copyright 2018 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 idl_test
+
+// This example shows how to use the mapType atomic attribute to
+// specify that this map should be treated as a whole.
+func ExampleMapType_atomic() {
+	type SomeAPI struct {
+		// +mapType=atomic
+		elements map[string]string
+	}
+}

vendor/k8s.io/kube-openapi/pkg/idl/structtype_test.go

@@ -0,0 +1,30 @@
+/*
+Copyright 2018 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 idl_test
+
+// This example shows how to use the structType atomic attribute to
+// specify that this struct should be treated as a whole.
+func ExampleStructType_atomic() {
+	type SomeStruct struct {
+		Name  string
+		Value string
+	}
+	type SomeAPI struct {
+		// +structType=atomic
+		elements SomeStruct
+	}
+}