markers

type Default ¶ added in v0.2.2

type Default struct {
	Value interface{}
}

Default sets the default value for this field.

A default value will be accepted as any value valid for the field. Formatting for common types include: boolean: `true`, string: `Cluster`, numerical: `1.24`, array: `{1,2}`, object: `{policy: "delete"}`). Defaults should be defined in pruned form, and only best-effort validation will be performed. Full validation of a default requires submission of the containing CRD to an apiserver.

func (m Default) ApplyToSchema(o *openapi3.Schema)

type Enum ¶ added in v0.2.2

type Enum []interface{}

Enum specifies that this (scalar) field is restricted to the *exact* values specified here.

func (m Enum) ApplyToSchema(o *openapi3.Schema)

type Example ¶ added in v0.2.2

type Example struct {
	Value interface{}
}

Example sets the example value for this field.

An example value will be accepted as any value valid for the field. Formatting for common types include: boolean: `true`, string: `Cluster`, numerical: `1.24`, array: `{1,2}`, object: `{policy: "delete"}`). Examples should be defined in pruned form, and only best-effort validation will be performed. Full validation of an example requires submission of the containing CRD to an apiserver.

func (m Example) ApplyToSchema(o *openapi3.Schema)

type ExclusiveMaximum ¶ added in v0.2.2

type ExclusiveMaximum bool

ExclusiveMaximum indicates that the maximum is "up to" but not including that value.

func (m ExclusiveMaximum) ApplyToSchema(o *openapi3.Schema)

type ExclusiveMinimum ¶ added in v0.2.2

type ExclusiveMinimum bool

ExclusiveMinimum indicates that the minimum is "up to" but not including that value.

func (m ExclusiveMinimum) ApplyToSchema(o *openapi3.Schema)

type Format ¶ added in v0.2.2

type Format string

Format specifies additional "complex" formatting for this field.

For example, a date-time field would be marked as "type: string" and "format: date-time".

func (m Format) ApplyToSchema(o *openapi3.Schema)

type MaxItems ¶ added in v0.2.2

type MaxItems int

MaxItems specifies the maximum length for this list.

func (m MaxItems) ApplyToSchema(o *openapi3.Schema)

type MaxLength ¶ added in v0.2.2

type MaxLength int

MaxLength specifies the maximum length for this string.

func (m MaxLength) ApplyToSchema(o *openapi3.Schema)

type MaxProperties ¶ added in v0.2.2

type MaxProperties int

MaxProperties restricts the number of keys in an object

func (m MaxProperties) ApplyToSchema(o *openapi3.Schema)

type Maximum ¶ added in v0.2.2

type Maximum float64

Maximum specifies the maximum numeric value that this field can have.

func (m Maximum) ApplyToSchema(o *openapi3.Schema)

func (m Maximum) Value() float64

type MinItems ¶ added in v0.2.2

type MinItems int

MinItems specifies the minimum length for this list.

func (m MinItems) ApplyToSchema(o *openapi3.Schema)

type MinLength ¶ added in v0.2.2

type MinLength int

MinLength specifies the minimum length for this string.

func (m MinLength) ApplyToSchema(o *openapi3.Schema)

type MinProperties ¶ added in v0.2.2

type MinProperties int

MinProperties restricts the number of keys in an object

func (m MinProperties) ApplyToSchema(o *openapi3.Schema)

type Minimum ¶ added in v0.2.2

type Minimum float64

Minimum specifies the minimum numeric value that this field can have. Negative numbers are supported.

func (m Minimum) ApplyToSchema(o *openapi3.Schema)

func (m Minimum) Value() float64

type MultipleOf ¶ added in v0.2.2

type MultipleOf float64

MultipleOf specifies that this field must have a numeric value that's a multiple of this one.

func (m MultipleOf) ApplyToSchema(o *openapi3.Schema)

func (m MultipleOf) Value() float64

type Nullable ¶ added in v0.2.2

type Nullable struct{}

Nullable marks this field as allowing the "null" value.

This is often not necessary, but may be helpful with custom serialization.

func (m Nullable) ApplyToSchema(o *openapi3.Schema)

type Pattern ¶ added in v0.2.2

type Pattern string

Pattern specifies that this string must match the given regular expression.

func (m Pattern) ApplyToSchema(o *openapi3.Schema)

type Registry ¶

type Registry struct {
	// contains filtered or unexported fields
}

func NewRegistry() (*Registry, error)

func (r *Registry) ApplyRulesToSchema(
	rules []string,
	o *openapi3.Schema,
	target markers.TargetType,
) error

func (r *Registry) GetSchemaType(
	rules []string,
	target markers.TargetType,
) Type

func (r *Registry) IsRequired(
	rules []string,
) bool

func (r *Registry) MustApplyRulesToSchema(
	rules []string,
	o *openapi3.Schema,
	target markers.TargetType,
)

type Required ¶ added in v0.2.2

type Required struct{}

Required marks a field as required.

func (m Required) ApplyToSchema(o *openapi3.Schema)

type SchemaMarker ¶

type SchemaMarker interface {
	ApplyToSchema(o *openapi3.Schema)
}

type Schemaless ¶ added in v0.2.2

type Schemaless struct{}

Schemaless marks a field as being a schemaless object.

Schemaless objects are not introspected, so you must provide any type and validation information yourself. One use for this tag is for embedding fields that hold JSONSchema typed objects. Because this field disables all type checking, it is recommended to be used only as a last resort.

func (m Schemaless) ApplyToSchema(o *openapi3.Schema)

type Type ¶

type Type string

Type is a marker that specifies the type of a field in the schema It only supports the following types: - object: an opaque object - value: an opauqe value

const (
	TypeObject Type = "object"
	TypeValue  Type = "value"
)

func (m Type) ApplyToSchema(o *openapi3.Schema)

type UniqueItems ¶ added in v0.2.2

type UniqueItems bool

UniqueItems specifies that all items in this list must be unique.

func (m UniqueItems) ApplyToSchema(o *openapi3.Schema)

type XEmbeddedResource ¶ added in v0.2.2

type XEmbeddedResource struct{}

EmbeddedResource marks a fields as an embedded resource with apiVersion, kind and metadata fields.

An embedded resource is a value that has apiVersion, kind and metadata fields. They are validated implicitly according to the semantics of the currently running apiserver. It is not necessary to add any additional schema for these field, yet it is possible. This can be combined with PreserveUnknownFields.

func (m XEmbeddedResource) ApplyToSchema(o *openapi3.Schema)

type XIntOrString ¶ added in v0.2.2

type XIntOrString struct{}

IntOrString marks a fields as an IntOrString.

This is required when applying patterns or other validations to an IntOrString field. Knwon information about the type is applied during the collapse phase and as such is not normally available during marker application.

func (m XIntOrString) ApplyToSchema(o *openapi3.Schema)

type XPreserveUnknownFields ¶ added in v0.2.2

type XPreserveUnknownFields struct{}

PreserveUnknownFields stops the apiserver from pruning fields which are not specified.

By default the apiserver drops unknown fields from the request payload during the decoding step. This marker stops the API server from doing so. It affects fields recursively, but switches back to normal pruning behaviour if nested properties or additionalProperties are specified in the schema. This can either be true or undefined. False is forbidden.

Note: The kubebuilder:validation:XPreserveUnknownFields variant is deprecated in favor of the kubebuilder:pruning:PreserveUnknownFields variant. They function identically.

func (m XPreserveUnknownFields) ApplyToSchema(o *openapi3.Schema)

type XValidation ¶

type XValidation struct {
	Rule              string `json:"rule"`
	Message           string `marker:",optional" json:"message,omitempty"`
	MessageExpression string `marker:",optional" json:"messageExpression,omitempty"`
}

XValidation marks a field as requiring a value for which a given expression evaluates to true.

This marker may be repeated to specify multiple expressions, all of which must evaluate to true.

func (x XValidation) ApplyToSchema(o *openapi3.Schema)