Update client-go
This commit is contained in:
2
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/.gitignore
generated
vendored
Normal file
2
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/.gitignore
generated
vendored
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
.idea/*
|
||||||
|
|
||||||
@@ -1,4 +1,6 @@
|
|||||||
[](https://travis-ci.org/spf13/pflag)
|
[](https://travis-ci.org/spf13/pflag)
|
||||||
|
[](https://goreportcard.com/report/github.com/spf13/pflag)
|
||||||
|
[](https://godoc.org/github.com/spf13/pflag)
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
@@ -106,9 +108,9 @@ that give one-letter shorthands for flags. You can use these by appending
|
|||||||
var ip = flag.IntP("flagname", "f", 1234, "help message")
|
var ip = flag.IntP("flagname", "f", 1234, "help message")
|
||||||
var flagvar bool
|
var flagvar bool
|
||||||
func init() {
|
func init() {
|
||||||
flag.BoolVarP("boolname", "b", true, "help message")
|
flag.BoolVarP(&flagvar, "boolname", "b", true, "help message")
|
||||||
}
|
}
|
||||||
flag.VarP(&flagVar, "varname", "v", 1234, "help message")
|
flag.VarP(&flagVal, "varname", "v", "help message")
|
||||||
```
|
```
|
||||||
|
|
||||||
Shorthand letters can be used with single dashes on the command line.
|
Shorthand letters can be used with single dashes on the command line.
|
||||||
|
|||||||
147
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/bool_slice.go
generated
Normal file
147
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/bool_slice.go
generated
Normal file
@@ -0,0 +1,147 @@
|
|||||||
|
package pflag
|
||||||
|
|
||||||
|
import (
|
||||||
|
"io"
|
||||||
|
"strconv"
|
||||||
|
"strings"
|
||||||
|
)
|
||||||
|
|
||||||
|
// -- boolSlice Value
|
||||||
|
type boolSliceValue struct {
|
||||||
|
value *[]bool
|
||||||
|
changed bool
|
||||||
|
}
|
||||||
|
|
||||||
|
func newBoolSliceValue(val []bool, p *[]bool) *boolSliceValue {
|
||||||
|
bsv := new(boolSliceValue)
|
||||||
|
bsv.value = p
|
||||||
|
*bsv.value = val
|
||||||
|
return bsv
|
||||||
|
}
|
||||||
|
|
||||||
|
// Set converts, and assigns, the comma-separated boolean argument string representation as the []bool value of this flag.
|
||||||
|
// If Set is called on a flag that already has a []bool assigned, the newly converted values will be appended.
|
||||||
|
func (s *boolSliceValue) Set(val string) error {
|
||||||
|
|
||||||
|
// remove all quote characters
|
||||||
|
rmQuote := strings.NewReplacer(`"`, "", `'`, "", "`", "")
|
||||||
|
|
||||||
|
// read flag arguments with CSV parser
|
||||||
|
boolStrSlice, err := readAsCSV(rmQuote.Replace(val))
|
||||||
|
if err != nil && err != io.EOF {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
// parse boolean values into slice
|
||||||
|
out := make([]bool, 0, len(boolStrSlice))
|
||||||
|
for _, boolStr := range boolStrSlice {
|
||||||
|
b, err := strconv.ParseBool(strings.TrimSpace(boolStr))
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
out = append(out, b)
|
||||||
|
}
|
||||||
|
|
||||||
|
if !s.changed {
|
||||||
|
*s.value = out
|
||||||
|
} else {
|
||||||
|
*s.value = append(*s.value, out...)
|
||||||
|
}
|
||||||
|
|
||||||
|
s.changed = true
|
||||||
|
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// Type returns a string that uniquely represents this flag's type.
|
||||||
|
func (s *boolSliceValue) Type() string {
|
||||||
|
return "boolSlice"
|
||||||
|
}
|
||||||
|
|
||||||
|
// String defines a "native" format for this boolean slice flag value.
|
||||||
|
func (s *boolSliceValue) String() string {
|
||||||
|
|
||||||
|
boolStrSlice := make([]string, len(*s.value))
|
||||||
|
for i, b := range *s.value {
|
||||||
|
boolStrSlice[i] = strconv.FormatBool(b)
|
||||||
|
}
|
||||||
|
|
||||||
|
out, _ := writeAsCSV(boolStrSlice)
|
||||||
|
|
||||||
|
return "[" + out + "]"
|
||||||
|
}
|
||||||
|
|
||||||
|
func boolSliceConv(val string) (interface{}, error) {
|
||||||
|
val = strings.Trim(val, "[]")
|
||||||
|
// Empty string would cause a slice with one (empty) entry
|
||||||
|
if len(val) == 0 {
|
||||||
|
return []bool{}, nil
|
||||||
|
}
|
||||||
|
ss := strings.Split(val, ",")
|
||||||
|
out := make([]bool, len(ss))
|
||||||
|
for i, t := range ss {
|
||||||
|
var err error
|
||||||
|
out[i], err = strconv.ParseBool(t)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return out, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetBoolSlice returns the []bool value of a flag with the given name.
|
||||||
|
func (f *FlagSet) GetBoolSlice(name string) ([]bool, error) {
|
||||||
|
val, err := f.getFlagType(name, "boolSlice", boolSliceConv)
|
||||||
|
if err != nil {
|
||||||
|
return []bool{}, err
|
||||||
|
}
|
||||||
|
return val.([]bool), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceVar defines a boolSlice flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a []bool variable in which to store the value of the flag.
|
||||||
|
func (f *FlagSet) BoolSliceVar(p *[]bool, name string, value []bool, usage string) {
|
||||||
|
f.VarP(newBoolSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceVarP is like BoolSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) BoolSliceVarP(p *[]bool, name, shorthand string, value []bool, usage string) {
|
||||||
|
f.VarP(newBoolSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceVar defines a []bool flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a []bool variable in which to store the value of the flag.
|
||||||
|
func BoolSliceVar(p *[]bool, name string, value []bool, usage string) {
|
||||||
|
CommandLine.VarP(newBoolSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceVarP is like BoolSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func BoolSliceVarP(p *[]bool, name, shorthand string, value []bool, usage string) {
|
||||||
|
CommandLine.VarP(newBoolSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSlice defines a []bool flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []bool variable that stores the value of the flag.
|
||||||
|
func (f *FlagSet) BoolSlice(name string, value []bool, usage string) *[]bool {
|
||||||
|
p := []bool{}
|
||||||
|
f.BoolSliceVarP(&p, name, "", value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceP is like BoolSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) BoolSliceP(name, shorthand string, value []bool, usage string) *[]bool {
|
||||||
|
p := []bool{}
|
||||||
|
f.BoolSliceVarP(&p, name, shorthand, value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSlice defines a []bool flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []bool variable that stores the value of the flag.
|
||||||
|
func BoolSlice(name string, value []bool, usage string) *[]bool {
|
||||||
|
return CommandLine.BoolSliceP(name, "", value, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// BoolSliceP is like BoolSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func BoolSliceP(name, shorthand string, value []bool, usage string) *[]bool {
|
||||||
|
return CommandLine.BoolSliceP(name, shorthand, value, usage)
|
||||||
|
}
|
||||||
@@ -487,9 +487,76 @@ func UnquoteUsage(flag *Flag) (name string, usage string) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// FlagUsages Returns a string containing the usage information for all flags in
|
// Splits the string `s` on whitespace into an initial substring up to
|
||||||
// the FlagSet
|
// `i` runes in length and the remainder. Will go `slop` over `i` if
|
||||||
func (f *FlagSet) FlagUsages() string {
|
// that encompasses the entire string (which allows the caller to
|
||||||
|
// avoid short orphan words on the final line).
|
||||||
|
func wrapN(i, slop int, s string) (string, string) {
|
||||||
|
if i+slop > len(s) {
|
||||||
|
return s, ""
|
||||||
|
}
|
||||||
|
|
||||||
|
w := strings.LastIndexAny(s[:i], " \t")
|
||||||
|
if w <= 0 {
|
||||||
|
return s, ""
|
||||||
|
}
|
||||||
|
|
||||||
|
return s[:w], s[w+1:]
|
||||||
|
}
|
||||||
|
|
||||||
|
// Wraps the string `s` to a maximum width `w` with leading indent
|
||||||
|
// `i`. The first line is not indented (this is assumed to be done by
|
||||||
|
// caller). Pass `w` == 0 to do no wrapping
|
||||||
|
func wrap(i, w int, s string) string {
|
||||||
|
if w == 0 {
|
||||||
|
return s
|
||||||
|
}
|
||||||
|
|
||||||
|
// space between indent i and end of line width w into which
|
||||||
|
// we should wrap the text.
|
||||||
|
wrap := w - i
|
||||||
|
|
||||||
|
var r, l string
|
||||||
|
|
||||||
|
// Not enough space for sensible wrapping. Wrap as a block on
|
||||||
|
// the next line instead.
|
||||||
|
if wrap < 24 {
|
||||||
|
i = 16
|
||||||
|
wrap = w - i
|
||||||
|
r += "\n" + strings.Repeat(" ", i)
|
||||||
|
}
|
||||||
|
// If still not enough space then don't even try to wrap.
|
||||||
|
if wrap < 24 {
|
||||||
|
return s
|
||||||
|
}
|
||||||
|
|
||||||
|
// Try to avoid short orphan words on the final line, by
|
||||||
|
// allowing wrapN to go a bit over if that would fit in the
|
||||||
|
// remainder of the line.
|
||||||
|
slop := 5
|
||||||
|
wrap = wrap - slop
|
||||||
|
|
||||||
|
// Handle first line, which is indented by the caller (or the
|
||||||
|
// special case above)
|
||||||
|
l, s = wrapN(wrap, slop, s)
|
||||||
|
r = r + l
|
||||||
|
|
||||||
|
// Now wrap the rest
|
||||||
|
for s != "" {
|
||||||
|
var t string
|
||||||
|
|
||||||
|
t, s = wrapN(wrap, slop, s)
|
||||||
|
r = r + "\n" + strings.Repeat(" ", i) + t
|
||||||
|
}
|
||||||
|
|
||||||
|
return r
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
// FlagUsagesWrapped returns a string containing the usage information
|
||||||
|
// for all flags in the FlagSet. Wrapped to `cols` columns (0 for no
|
||||||
|
// wrapping)
|
||||||
|
func (f *FlagSet) FlagUsagesWrapped(cols int) string {
|
||||||
x := new(bytes.Buffer)
|
x := new(bytes.Buffer)
|
||||||
|
|
||||||
lines := make([]string, 0, len(f.formal))
|
lines := make([]string, 0, len(f.formal))
|
||||||
@@ -546,12 +613,19 @@ func (f *FlagSet) FlagUsages() string {
|
|||||||
for _, line := range lines {
|
for _, line := range lines {
|
||||||
sidx := strings.Index(line, "\x00")
|
sidx := strings.Index(line, "\x00")
|
||||||
spacing := strings.Repeat(" ", maxlen-sidx)
|
spacing := strings.Repeat(" ", maxlen-sidx)
|
||||||
fmt.Fprintln(x, line[:sidx], spacing, line[sidx+1:])
|
// maxlen + 2 comes from + 1 for the \x00 and + 1 for the (deliberate) off-by-one in maxlen-sidx
|
||||||
|
fmt.Fprintln(x, line[:sidx], spacing, wrap(maxlen+2, cols, line[sidx+1:]))
|
||||||
}
|
}
|
||||||
|
|
||||||
return x.String()
|
return x.String()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// FlagUsages returns a string containing the usage information for all flags in
|
||||||
|
// the FlagSet
|
||||||
|
func (f *FlagSet) FlagUsages() string {
|
||||||
|
return f.FlagUsagesWrapped(0)
|
||||||
|
}
|
||||||
|
|
||||||
// PrintDefaults prints to standard error the default values of all defined command-line flags.
|
// PrintDefaults prints to standard error the default values of all defined command-line flags.
|
||||||
func PrintDefaults() {
|
func PrintDefaults() {
|
||||||
CommandLine.PrintDefaults()
|
CommandLine.PrintDefaults()
|
||||||
@@ -635,7 +709,7 @@ func (f *FlagSet) VarPF(value Value, name, shorthand, usage string) *Flag {
|
|||||||
|
|
||||||
// VarP is like Var, but accepts a shorthand letter that can be used after a single dash.
|
// VarP is like Var, but accepts a shorthand letter that can be used after a single dash.
|
||||||
func (f *FlagSet) VarP(value Value, name, shorthand, usage string) {
|
func (f *FlagSet) VarP(value Value, name, shorthand, usage string) {
|
||||||
_ = f.VarPF(value, name, shorthand, usage)
|
f.VarPF(value, name, shorthand, usage)
|
||||||
}
|
}
|
||||||
|
|
||||||
// AddFlag will add the flag to the FlagSet
|
// AddFlag will add the flag to the FlagSet
|
||||||
@@ -752,7 +826,7 @@ func containsShorthand(arg, shorthand string) bool {
|
|||||||
return strings.Contains(arg, shorthand)
|
return strings.Contains(arg, shorthand)
|
||||||
}
|
}
|
||||||
|
|
||||||
func (f *FlagSet) parseLongArg(s string, args []string) (a []string, err error) {
|
func (f *FlagSet) parseLongArg(s string, args []string, fn parseFunc) (a []string, err error) {
|
||||||
a = args
|
a = args
|
||||||
name := s[2:]
|
name := s[2:]
|
||||||
if len(name) == 0 || name[0] == '-' || name[0] == '=' {
|
if len(name) == 0 || name[0] == '-' || name[0] == '=' {
|
||||||
@@ -786,11 +860,11 @@ func (f *FlagSet) parseLongArg(s string, args []string) (a []string, err error)
|
|||||||
err = f.failf("flag needs an argument: %s", s)
|
err = f.failf("flag needs an argument: %s", s)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
err = f.setFlag(flag, value, s)
|
err = fn(flag, value, s)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
func (f *FlagSet) parseSingleShortArg(shorthands string, args []string) (outShorts string, outArgs []string, err error) {
|
func (f *FlagSet) parseSingleShortArg(shorthands string, args []string, fn parseFunc) (outShorts string, outArgs []string, err error) {
|
||||||
if strings.HasPrefix(shorthands, "test.") {
|
if strings.HasPrefix(shorthands, "test.") {
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
@@ -825,16 +899,16 @@ func (f *FlagSet) parseSingleShortArg(shorthands string, args []string) (outShor
|
|||||||
err = f.failf("flag needs an argument: %q in -%s", c, shorthands)
|
err = f.failf("flag needs an argument: %q in -%s", c, shorthands)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
err = f.setFlag(flag, value, shorthands)
|
err = fn(flag, value, shorthands)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
func (f *FlagSet) parseShortArg(s string, args []string) (a []string, err error) {
|
func (f *FlagSet) parseShortArg(s string, args []string, fn parseFunc) (a []string, err error) {
|
||||||
a = args
|
a = args
|
||||||
shorthands := s[1:]
|
shorthands := s[1:]
|
||||||
|
|
||||||
for len(shorthands) > 0 {
|
for len(shorthands) > 0 {
|
||||||
shorthands, a, err = f.parseSingleShortArg(shorthands, args)
|
shorthands, a, err = f.parseSingleShortArg(shorthands, args, fn)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
@@ -843,7 +917,7 @@ func (f *FlagSet) parseShortArg(s string, args []string) (a []string, err error)
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
func (f *FlagSet) parseArgs(args []string) (err error) {
|
func (f *FlagSet) parseArgs(args []string, fn parseFunc) (err error) {
|
||||||
for len(args) > 0 {
|
for len(args) > 0 {
|
||||||
s := args[0]
|
s := args[0]
|
||||||
args = args[1:]
|
args = args[1:]
|
||||||
@@ -863,9 +937,9 @@ func (f *FlagSet) parseArgs(args []string) (err error) {
|
|||||||
f.args = append(f.args, args...)
|
f.args = append(f.args, args...)
|
||||||
break
|
break
|
||||||
}
|
}
|
||||||
args, err = f.parseLongArg(s, args)
|
args, err = f.parseLongArg(s, args, fn)
|
||||||
} else {
|
} else {
|
||||||
args, err = f.parseShortArg(s, args)
|
args, err = f.parseShortArg(s, args, fn)
|
||||||
}
|
}
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return
|
return
|
||||||
@@ -881,7 +955,41 @@ func (f *FlagSet) parseArgs(args []string) (err error) {
|
|||||||
func (f *FlagSet) Parse(arguments []string) error {
|
func (f *FlagSet) Parse(arguments []string) error {
|
||||||
f.parsed = true
|
f.parsed = true
|
||||||
f.args = make([]string, 0, len(arguments))
|
f.args = make([]string, 0, len(arguments))
|
||||||
err := f.parseArgs(arguments)
|
|
||||||
|
assign := func(flag *Flag, value, origArg string) error {
|
||||||
|
return f.setFlag(flag, value, origArg)
|
||||||
|
}
|
||||||
|
|
||||||
|
err := f.parseArgs(arguments, assign)
|
||||||
|
if err != nil {
|
||||||
|
switch f.errorHandling {
|
||||||
|
case ContinueOnError:
|
||||||
|
return err
|
||||||
|
case ExitOnError:
|
||||||
|
os.Exit(2)
|
||||||
|
case PanicOnError:
|
||||||
|
panic(err)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
type parseFunc func(flag *Flag, value, origArg string) error
|
||||||
|
|
||||||
|
// ParseAll parses flag definitions from the argument list, which should not
|
||||||
|
// include the command name. The arguments for fn are flag and value. Must be
|
||||||
|
// called after all flags in the FlagSet are defined and before flags are
|
||||||
|
// accessed by the program. The return value will be ErrHelp if -help was set
|
||||||
|
// but not defined.
|
||||||
|
func (f *FlagSet) ParseAll(arguments []string, fn func(flag *Flag, value string) error) error {
|
||||||
|
f.parsed = true
|
||||||
|
f.args = make([]string, 0, len(arguments))
|
||||||
|
|
||||||
|
assign := func(flag *Flag, value, origArg string) error {
|
||||||
|
return fn(flag, value)
|
||||||
|
}
|
||||||
|
|
||||||
|
err := f.parseArgs(arguments, assign)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
switch f.errorHandling {
|
switch f.errorHandling {
|
||||||
case ContinueOnError:
|
case ContinueOnError:
|
||||||
@@ -907,6 +1015,14 @@ func Parse() {
|
|||||||
CommandLine.Parse(os.Args[1:])
|
CommandLine.Parse(os.Args[1:])
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ParseAll parses the command-line flags from os.Args[1:] and called fn for each.
|
||||||
|
// The arguments for fn are flag and value. Must be called after all flags are
|
||||||
|
// defined and before flags are accessed by the program.
|
||||||
|
func ParseAll(fn func(flag *Flag, value string) error) {
|
||||||
|
// Ignore errors; CommandLine is set for ExitOnError.
|
||||||
|
CommandLine.ParseAll(os.Args[1:], fn)
|
||||||
|
}
|
||||||
|
|
||||||
// SetInterspersed sets whether to support interspersed option/non-option arguments.
|
// SetInterspersed sets whether to support interspersed option/non-option arguments.
|
||||||
func SetInterspersed(interspersed bool) {
|
func SetInterspersed(interspersed bool) {
|
||||||
CommandLine.SetInterspersed(interspersed)
|
CommandLine.SetInterspersed(interspersed)
|
||||||
|
|||||||
@@ -6,13 +6,10 @@ package pflag
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
goflag "flag"
|
goflag "flag"
|
||||||
"fmt"
|
|
||||||
"reflect"
|
"reflect"
|
||||||
"strings"
|
"strings"
|
||||||
)
|
)
|
||||||
|
|
||||||
var _ = fmt.Print
|
|
||||||
|
|
||||||
// flagValueWrapper implements pflag.Value around a flag.Value. The main
|
// flagValueWrapper implements pflag.Value around a flag.Value. The main
|
||||||
// difference here is the addition of the Type method that returns a string
|
// difference here is the addition of the Type method that returns a string
|
||||||
// name of the type. As this is generally unknown, we approximate that with
|
// name of the type. As this is generally unknown, we approximate that with
|
||||||
|
|||||||
@@ -6,8 +6,6 @@ import (
|
|||||||
"strings"
|
"strings"
|
||||||
)
|
)
|
||||||
|
|
||||||
var _ = strings.TrimSpace
|
|
||||||
|
|
||||||
// -- net.IP value
|
// -- net.IP value
|
||||||
type ipValue net.IP
|
type ipValue net.IP
|
||||||
|
|
||||||
|
|||||||
148
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/ip_slice.go
generated
Normal file
148
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/ip_slice.go
generated
Normal file
@@ -0,0 +1,148 @@
|
|||||||
|
package pflag
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"io"
|
||||||
|
"net"
|
||||||
|
"strings"
|
||||||
|
)
|
||||||
|
|
||||||
|
// -- ipSlice Value
|
||||||
|
type ipSliceValue struct {
|
||||||
|
value *[]net.IP
|
||||||
|
changed bool
|
||||||
|
}
|
||||||
|
|
||||||
|
func newIPSliceValue(val []net.IP, p *[]net.IP) *ipSliceValue {
|
||||||
|
ipsv := new(ipSliceValue)
|
||||||
|
ipsv.value = p
|
||||||
|
*ipsv.value = val
|
||||||
|
return ipsv
|
||||||
|
}
|
||||||
|
|
||||||
|
// Set converts, and assigns, the comma-separated IP argument string representation as the []net.IP value of this flag.
|
||||||
|
// If Set is called on a flag that already has a []net.IP assigned, the newly converted values will be appended.
|
||||||
|
func (s *ipSliceValue) Set(val string) error {
|
||||||
|
|
||||||
|
// remove all quote characters
|
||||||
|
rmQuote := strings.NewReplacer(`"`, "", `'`, "", "`", "")
|
||||||
|
|
||||||
|
// read flag arguments with CSV parser
|
||||||
|
ipStrSlice, err := readAsCSV(rmQuote.Replace(val))
|
||||||
|
if err != nil && err != io.EOF {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
// parse ip values into slice
|
||||||
|
out := make([]net.IP, 0, len(ipStrSlice))
|
||||||
|
for _, ipStr := range ipStrSlice {
|
||||||
|
ip := net.ParseIP(strings.TrimSpace(ipStr))
|
||||||
|
if ip == nil {
|
||||||
|
return fmt.Errorf("invalid string being converted to IP address: %s", ipStr)
|
||||||
|
}
|
||||||
|
out = append(out, ip)
|
||||||
|
}
|
||||||
|
|
||||||
|
if !s.changed {
|
||||||
|
*s.value = out
|
||||||
|
} else {
|
||||||
|
*s.value = append(*s.value, out...)
|
||||||
|
}
|
||||||
|
|
||||||
|
s.changed = true
|
||||||
|
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// Type returns a string that uniquely represents this flag's type.
|
||||||
|
func (s *ipSliceValue) Type() string {
|
||||||
|
return "ipSlice"
|
||||||
|
}
|
||||||
|
|
||||||
|
// String defines a "native" format for this net.IP slice flag value.
|
||||||
|
func (s *ipSliceValue) String() string {
|
||||||
|
|
||||||
|
ipStrSlice := make([]string, len(*s.value))
|
||||||
|
for i, ip := range *s.value {
|
||||||
|
ipStrSlice[i] = ip.String()
|
||||||
|
}
|
||||||
|
|
||||||
|
out, _ := writeAsCSV(ipStrSlice)
|
||||||
|
|
||||||
|
return "[" + out + "]"
|
||||||
|
}
|
||||||
|
|
||||||
|
func ipSliceConv(val string) (interface{}, error) {
|
||||||
|
val = strings.Trim(val, "[]")
|
||||||
|
// Emtpy string would cause a slice with one (empty) entry
|
||||||
|
if len(val) == 0 {
|
||||||
|
return []net.IP{}, nil
|
||||||
|
}
|
||||||
|
ss := strings.Split(val, ",")
|
||||||
|
out := make([]net.IP, len(ss))
|
||||||
|
for i, sval := range ss {
|
||||||
|
ip := net.ParseIP(strings.TrimSpace(sval))
|
||||||
|
if ip == nil {
|
||||||
|
return nil, fmt.Errorf("invalid string being converted to IP address: %s", sval)
|
||||||
|
}
|
||||||
|
out[i] = ip
|
||||||
|
}
|
||||||
|
return out, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetIPSlice returns the []net.IP value of a flag with the given name
|
||||||
|
func (f *FlagSet) GetIPSlice(name string) ([]net.IP, error) {
|
||||||
|
val, err := f.getFlagType(name, "ipSlice", ipSliceConv)
|
||||||
|
if err != nil {
|
||||||
|
return []net.IP{}, err
|
||||||
|
}
|
||||||
|
return val.([]net.IP), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceVar defines a ipSlice flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a []net.IP variable in which to store the value of the flag.
|
||||||
|
func (f *FlagSet) IPSliceVar(p *[]net.IP, name string, value []net.IP, usage string) {
|
||||||
|
f.VarP(newIPSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceVarP is like IPSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) IPSliceVarP(p *[]net.IP, name, shorthand string, value []net.IP, usage string) {
|
||||||
|
f.VarP(newIPSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceVar defines a []net.IP flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a []net.IP variable in which to store the value of the flag.
|
||||||
|
func IPSliceVar(p *[]net.IP, name string, value []net.IP, usage string) {
|
||||||
|
CommandLine.VarP(newIPSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceVarP is like IPSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func IPSliceVarP(p *[]net.IP, name, shorthand string, value []net.IP, usage string) {
|
||||||
|
CommandLine.VarP(newIPSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSlice defines a []net.IP flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []net.IP variable that stores the value of that flag.
|
||||||
|
func (f *FlagSet) IPSlice(name string, value []net.IP, usage string) *[]net.IP {
|
||||||
|
p := []net.IP{}
|
||||||
|
f.IPSliceVarP(&p, name, "", value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceP is like IPSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) IPSliceP(name, shorthand string, value []net.IP, usage string) *[]net.IP {
|
||||||
|
p := []net.IP{}
|
||||||
|
f.IPSliceVarP(&p, name, shorthand, value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSlice defines a []net.IP flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []net.IP variable that stores the value of the flag.
|
||||||
|
func IPSlice(name string, value []net.IP, usage string) *[]net.IP {
|
||||||
|
return CommandLine.IPSliceP(name, "", value, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// IPSliceP is like IPSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func IPSliceP(name, shorthand string, value []net.IP, usage string) *[]net.IP {
|
||||||
|
return CommandLine.IPSliceP(name, shorthand, value, usage)
|
||||||
|
}
|
||||||
@@ -27,8 +27,6 @@ func (*ipNetValue) Type() string {
|
|||||||
return "ipNet"
|
return "ipNet"
|
||||||
}
|
}
|
||||||
|
|
||||||
var _ = strings.TrimSpace
|
|
||||||
|
|
||||||
func newIPNetValue(val net.IPNet, p *net.IPNet) *ipNetValue {
|
func newIPNetValue(val net.IPNet, p *net.IPNet) *ipNetValue {
|
||||||
*p = val
|
*p = val
|
||||||
return (*ipNetValue)(p)
|
return (*ipNetValue)(p)
|
||||||
|
|||||||
@@ -1,11 +1,5 @@
|
|||||||
package pflag
|
package pflag
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
)
|
|
||||||
|
|
||||||
var _ = fmt.Fprint
|
|
||||||
|
|
||||||
// -- stringArray Value
|
// -- stringArray Value
|
||||||
type stringArrayValue struct {
|
type stringArrayValue struct {
|
||||||
value *[]string
|
value *[]string
|
||||||
|
|||||||
@@ -3,12 +3,9 @@ package pflag
|
|||||||
import (
|
import (
|
||||||
"bytes"
|
"bytes"
|
||||||
"encoding/csv"
|
"encoding/csv"
|
||||||
"fmt"
|
|
||||||
"strings"
|
"strings"
|
||||||
)
|
)
|
||||||
|
|
||||||
var _ = fmt.Fprint
|
|
||||||
|
|
||||||
// -- stringSlice Value
|
// -- stringSlice Value
|
||||||
type stringSliceValue struct {
|
type stringSliceValue struct {
|
||||||
value *[]string
|
value *[]string
|
||||||
@@ -39,7 +36,7 @@ func writeAsCSV(vals []string) (string, error) {
|
|||||||
return "", err
|
return "", err
|
||||||
}
|
}
|
||||||
w.Flush()
|
w.Flush()
|
||||||
return strings.TrimSuffix(b.String(), fmt.Sprintln()), nil
|
return strings.TrimSuffix(b.String(), "\n"), nil
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *stringSliceValue) Set(val string) error {
|
func (s *stringSliceValue) Set(val string) error {
|
||||||
|
|||||||
126
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/uint_slice.go
generated
Normal file
126
staging/src/k8s.io/client-go/_vendor/github.com/spf13/pflag/uint_slice.go
generated
Normal file
@@ -0,0 +1,126 @@
|
|||||||
|
package pflag
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"strconv"
|
||||||
|
"strings"
|
||||||
|
)
|
||||||
|
|
||||||
|
// -- uintSlice Value
|
||||||
|
type uintSliceValue struct {
|
||||||
|
value *[]uint
|
||||||
|
changed bool
|
||||||
|
}
|
||||||
|
|
||||||
|
func newUintSliceValue(val []uint, p *[]uint) *uintSliceValue {
|
||||||
|
uisv := new(uintSliceValue)
|
||||||
|
uisv.value = p
|
||||||
|
*uisv.value = val
|
||||||
|
return uisv
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *uintSliceValue) Set(val string) error {
|
||||||
|
ss := strings.Split(val, ",")
|
||||||
|
out := make([]uint, len(ss))
|
||||||
|
for i, d := range ss {
|
||||||
|
u, err := strconv.ParseUint(d, 10, 0)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
out[i] = uint(u)
|
||||||
|
}
|
||||||
|
if !s.changed {
|
||||||
|
*s.value = out
|
||||||
|
} else {
|
||||||
|
*s.value = append(*s.value, out...)
|
||||||
|
}
|
||||||
|
s.changed = true
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *uintSliceValue) Type() string {
|
||||||
|
return "uintSlice"
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *uintSliceValue) String() string {
|
||||||
|
out := make([]string, len(*s.value))
|
||||||
|
for i, d := range *s.value {
|
||||||
|
out[i] = fmt.Sprintf("%d", d)
|
||||||
|
}
|
||||||
|
return "[" + strings.Join(out, ",") + "]"
|
||||||
|
}
|
||||||
|
|
||||||
|
func uintSliceConv(val string) (interface{}, error) {
|
||||||
|
val = strings.Trim(val, "[]")
|
||||||
|
// Empty string would cause a slice with one (empty) entry
|
||||||
|
if len(val) == 0 {
|
||||||
|
return []uint{}, nil
|
||||||
|
}
|
||||||
|
ss := strings.Split(val, ",")
|
||||||
|
out := make([]uint, len(ss))
|
||||||
|
for i, d := range ss {
|
||||||
|
u, err := strconv.ParseUint(d, 10, 0)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
out[i] = uint(u)
|
||||||
|
}
|
||||||
|
return out, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetUintSlice returns the []uint value of a flag with the given name.
|
||||||
|
func (f *FlagSet) GetUintSlice(name string) ([]uint, error) {
|
||||||
|
val, err := f.getFlagType(name, "uintSlice", uintSliceConv)
|
||||||
|
if err != nil {
|
||||||
|
return []uint{}, err
|
||||||
|
}
|
||||||
|
return val.([]uint), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceVar defines a uintSlice flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a []uint variable in which to store the value of the flag.
|
||||||
|
func (f *FlagSet) UintSliceVar(p *[]uint, name string, value []uint, usage string) {
|
||||||
|
f.VarP(newUintSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceVarP is like UintSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) UintSliceVarP(p *[]uint, name, shorthand string, value []uint, usage string) {
|
||||||
|
f.VarP(newUintSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceVar defines a uint[] flag with specified name, default value, and usage string.
|
||||||
|
// The argument p points to a uint[] variable in which to store the value of the flag.
|
||||||
|
func UintSliceVar(p *[]uint, name string, value []uint, usage string) {
|
||||||
|
CommandLine.VarP(newUintSliceValue(value, p), name, "", usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceVarP is like the UintSliceVar, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func UintSliceVarP(p *[]uint, name, shorthand string, value []uint, usage string) {
|
||||||
|
CommandLine.VarP(newUintSliceValue(value, p), name, shorthand, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSlice defines a []uint flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []uint variable that stores the value of the flag.
|
||||||
|
func (f *FlagSet) UintSlice(name string, value []uint, usage string) *[]uint {
|
||||||
|
p := []uint{}
|
||||||
|
f.UintSliceVarP(&p, name, "", value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceP is like UintSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func (f *FlagSet) UintSliceP(name, shorthand string, value []uint, usage string) *[]uint {
|
||||||
|
p := []uint{}
|
||||||
|
f.UintSliceVarP(&p, name, shorthand, value, usage)
|
||||||
|
return &p
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSlice defines a []uint flag with specified name, default value, and usage string.
|
||||||
|
// The return value is the address of a []uint variable that stores the value of the flag.
|
||||||
|
func UintSlice(name string, value []uint, usage string) *[]uint {
|
||||||
|
return CommandLine.UintSliceP(name, "", value, usage)
|
||||||
|
}
|
||||||
|
|
||||||
|
// UintSliceP is like UintSlice, but accepts a shorthand letter that can be used after a single dash.
|
||||||
|
func UintSliceP(name, shorthand string, value []uint, usage string) *[]uint {
|
||||||
|
return CommandLine.UintSliceP(name, shorthand, value, usage)
|
||||||
|
}
|
||||||
@@ -1,202 +0,0 @@
|
|||||||
|
|
||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
http://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
APPENDIX: How to apply the Apache License to your work.
|
|
||||||
|
|
||||||
To apply the Apache License to your work, attach the following
|
|
||||||
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
||||||
replaced with your own identifying information. (Don't include
|
|
||||||
the brackets!) The text should be enclosed in the appropriate
|
|
||||||
comment syntax for the file format. We also recommend that a
|
|
||||||
file or class name and description of purpose be included on the
|
|
||||||
same "printed page" as the copyright notice for easier
|
|
||||||
identification within third-party archives.
|
|
||||||
|
|
||||||
Copyright [yyyy] [name of copyright owner]
|
|
||||||
|
|
||||||
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.
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 equality
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/api/resource"
|
|
||||||
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/fields"
|
|
||||||
"k8s.io/apimachinery/pkg/labels"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Semantic can do semantic deep equality checks for api objects.
|
|
||||||
// Example: apiequality.Semantic.DeepEqual(aPod, aPodWithNonNilButEmptyMaps) == true
|
|
||||||
var Semantic = conversion.EqualitiesOrDie(
|
|
||||||
func(a, b resource.Quantity) bool {
|
|
||||||
// Ignore formatting, only care that numeric value stayed the same.
|
|
||||||
// TODO: if we decide it's important, it should be safe to start comparing the format.
|
|
||||||
//
|
|
||||||
// Uninitialized quantities are equivalent to 0 quantities.
|
|
||||||
return a.Cmp(b) == 0
|
|
||||||
},
|
|
||||||
func(a, b metav1.Time) bool {
|
|
||||||
return a.UTC() == b.UTC()
|
|
||||||
},
|
|
||||||
func(a, b labels.Selector) bool {
|
|
||||||
return a.String() == b.String()
|
|
||||||
},
|
|
||||||
func(a, b fields.Selector) bool {
|
|
||||||
return a.String() == b.String()
|
|
||||||
},
|
|
||||||
)
|
|
||||||
@@ -1,27 +0,0 @@
|
|||||||
reviewers:
|
|
||||||
- thockin
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
- deads2k
|
|
||||||
- brendandburns
|
|
||||||
- derekwaynecarr
|
|
||||||
- caesarxuchao
|
|
||||||
- mikedanese
|
|
||||||
- liggitt
|
|
||||||
- nikhiljindal
|
|
||||||
- gmarek
|
|
||||||
- erictune
|
|
||||||
- saad-ali
|
|
||||||
- janetkuo
|
|
||||||
- timstclair
|
|
||||||
- eparis
|
|
||||||
- timothysc
|
|
||||||
- dims
|
|
||||||
- spxtr
|
|
||||||
- hongchaodeng
|
|
||||||
- krousey
|
|
||||||
- satnam6502
|
|
||||||
- cjcullen
|
|
||||||
- david-mcmahon
|
|
||||||
- goltermann
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 errors provides detailed error types for api field validation.
|
|
||||||
package errors
|
|
||||||
@@ -1,478 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 errors
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/util/validation/field"
|
|
||||||
)
|
|
||||||
|
|
||||||
// HTTP Status codes not in the golang http package.
|
|
||||||
const (
|
|
||||||
StatusUnprocessableEntity = 422
|
|
||||||
StatusTooManyRequests = 429
|
|
||||||
// StatusServerTimeout is an indication that a transient server error has
|
|
||||||
// occurred and the client *should* retry, with an optional Retry-After
|
|
||||||
// header to specify the back off window.
|
|
||||||
StatusServerTimeout = 504
|
|
||||||
)
|
|
||||||
|
|
||||||
// StatusError is an error intended for consumption by a REST API server; it can also be
|
|
||||||
// reconstructed by clients from a REST response. Public to allow easy type switches.
|
|
||||||
type StatusError struct {
|
|
||||||
ErrStatus metav1.Status
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIStatus is exposed by errors that can be converted to an api.Status object
|
|
||||||
// for finer grained details.
|
|
||||||
type APIStatus interface {
|
|
||||||
Status() metav1.Status
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ error = &StatusError{}
|
|
||||||
|
|
||||||
// Error implements the Error interface.
|
|
||||||
func (e *StatusError) Error() string {
|
|
||||||
return e.ErrStatus.Message
|
|
||||||
}
|
|
||||||
|
|
||||||
// Status allows access to e's status without having to know the detailed workings
|
|
||||||
// of StatusError.
|
|
||||||
func (e *StatusError) Status() metav1.Status {
|
|
||||||
return e.ErrStatus
|
|
||||||
}
|
|
||||||
|
|
||||||
// DebugError reports extended info about the error to debug output.
|
|
||||||
func (e *StatusError) DebugError() (string, []interface{}) {
|
|
||||||
if out, err := json.MarshalIndent(e.ErrStatus, "", " "); err == nil {
|
|
||||||
return "server response object: %s", []interface{}{string(out)}
|
|
||||||
}
|
|
||||||
return "server response object: %#v", []interface{}{e.ErrStatus}
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnexpectedObjectError can be returned by FromObject if it's passed a non-status object.
|
|
||||||
type UnexpectedObjectError struct {
|
|
||||||
Object runtime.Object
|
|
||||||
}
|
|
||||||
|
|
||||||
// Error returns an error message describing 'u'.
|
|
||||||
func (u *UnexpectedObjectError) Error() string {
|
|
||||||
return fmt.Sprintf("unexpected object: %v", u.Object)
|
|
||||||
}
|
|
||||||
|
|
||||||
// FromObject generates an StatusError from an metav1.Status, if that is the type of obj; otherwise,
|
|
||||||
// returns an UnexpecteObjectError.
|
|
||||||
func FromObject(obj runtime.Object) error {
|
|
||||||
switch t := obj.(type) {
|
|
||||||
case *metav1.Status:
|
|
||||||
return &StatusError{*t}
|
|
||||||
}
|
|
||||||
return &UnexpectedObjectError{obj}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewNotFound returns a new error which indicates that the resource of the kind and the name was not found.
|
|
||||||
func NewNotFound(qualifiedResource schema.GroupResource, name string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusNotFound,
|
|
||||||
Reason: metav1.StatusReasonNotFound,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: name,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("%s %q not found", qualifiedResource.String(), name),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewAlreadyExists returns an error indicating the item requested exists by that identifier.
|
|
||||||
func NewAlreadyExists(qualifiedResource schema.GroupResource, name string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusConflict,
|
|
||||||
Reason: metav1.StatusReasonAlreadyExists,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: name,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("%s %q already exists", qualifiedResource.String(), name),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewUnauthorized returns an error indicating the client is not authorized to perform the requested
|
|
||||||
// action.
|
|
||||||
func NewUnauthorized(reason string) *StatusError {
|
|
||||||
message := reason
|
|
||||||
if len(message) == 0 {
|
|
||||||
message = "not authorized"
|
|
||||||
}
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusUnauthorized,
|
|
||||||
Reason: metav1.StatusReasonUnauthorized,
|
|
||||||
Message: message,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewForbidden returns an error indicating the requested action was forbidden
|
|
||||||
func NewForbidden(qualifiedResource schema.GroupResource, name string, err error) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusForbidden,
|
|
||||||
Reason: metav1.StatusReasonForbidden,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: name,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("%s %q is forbidden: %v", qualifiedResource.String(), name, err),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewConflict returns an error indicating the item can't be updated as provided.
|
|
||||||
func NewConflict(qualifiedResource schema.GroupResource, name string, err error) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusConflict,
|
|
||||||
Reason: metav1.StatusReasonConflict,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: name,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("Operation cannot be fulfilled on %s %q: %v", qualifiedResource.String(), name, err),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewGone returns an error indicating the item no longer available at the server and no forwarding address is known.
|
|
||||||
func NewGone(message string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusGone,
|
|
||||||
Reason: metav1.StatusReasonGone,
|
|
||||||
Message: message,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewInvalid returns an error indicating the item is invalid and cannot be processed.
|
|
||||||
func NewInvalid(qualifiedKind schema.GroupKind, name string, errs field.ErrorList) *StatusError {
|
|
||||||
causes := make([]metav1.StatusCause, 0, len(errs))
|
|
||||||
for i := range errs {
|
|
||||||
err := errs[i]
|
|
||||||
causes = append(causes, metav1.StatusCause{
|
|
||||||
Type: metav1.CauseType(err.Type),
|
|
||||||
Message: err.ErrorBody(),
|
|
||||||
Field: err.Field,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: StatusUnprocessableEntity, // RFC 4918: StatusUnprocessableEntity
|
|
||||||
Reason: metav1.StatusReasonInvalid,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedKind.Group,
|
|
||||||
Kind: qualifiedKind.Kind,
|
|
||||||
Name: name,
|
|
||||||
Causes: causes,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("%s %q is invalid: %v", qualifiedKind.String(), name, errs.ToAggregate()),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewBadRequest creates an error that indicates that the request is invalid and can not be processed.
|
|
||||||
func NewBadRequest(reason string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusBadRequest,
|
|
||||||
Reason: metav1.StatusReasonBadRequest,
|
|
||||||
Message: reason,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewServiceUnavailable creates an error that indicates that the requested service is unavailable.
|
|
||||||
func NewServiceUnavailable(reason string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusServiceUnavailable,
|
|
||||||
Reason: metav1.StatusReasonServiceUnavailable,
|
|
||||||
Message: reason,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewMethodNotSupported returns an error indicating the requested action is not supported on this kind.
|
|
||||||
func NewMethodNotSupported(qualifiedResource schema.GroupResource, action string) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusMethodNotAllowed,
|
|
||||||
Reason: metav1.StatusReasonMethodNotAllowed,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("%s is not supported on resources of kind %q", action, qualifiedResource.String()),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewServerTimeout returns an error indicating the requested action could not be completed due to a
|
|
||||||
// transient error, and the client should try again.
|
|
||||||
func NewServerTimeout(qualifiedResource schema.GroupResource, operation string, retryAfterSeconds int) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusInternalServerError,
|
|
||||||
Reason: metav1.StatusReasonServerTimeout,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: operation,
|
|
||||||
RetryAfterSeconds: int32(retryAfterSeconds),
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("The %s operation against %s could not be completed at this time, please try again.", operation, qualifiedResource.String()),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewServerTimeoutForKind should not exist. Server timeouts happen when accessing resources, the Kind is just what we
|
|
||||||
// happened to be looking at when the request failed. This delegates to keep code sane, but we should work towards removing this.
|
|
||||||
func NewServerTimeoutForKind(qualifiedKind schema.GroupKind, operation string, retryAfterSeconds int) *StatusError {
|
|
||||||
return NewServerTimeout(schema.GroupResource{Group: qualifiedKind.Group, Resource: qualifiedKind.Kind}, operation, retryAfterSeconds)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewInternalError returns an error indicating the item is invalid and cannot be processed.
|
|
||||||
func NewInternalError(err error) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: http.StatusInternalServerError,
|
|
||||||
Reason: metav1.StatusReasonInternalError,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Causes: []metav1.StatusCause{{Message: err.Error()}},
|
|
||||||
},
|
|
||||||
Message: fmt.Sprintf("Internal error occurred: %v", err),
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewTimeoutError returns an error indicating that a timeout occurred before the request
|
|
||||||
// could be completed. Clients may retry, but the operation may still complete.
|
|
||||||
func NewTimeoutError(message string, retryAfterSeconds int) *StatusError {
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: StatusServerTimeout,
|
|
||||||
Reason: metav1.StatusReasonTimeout,
|
|
||||||
Message: fmt.Sprintf("Timeout: %s", message),
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
RetryAfterSeconds: int32(retryAfterSeconds),
|
|
||||||
},
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewGenericServerResponse returns a new error for server responses that are not in a recognizable form.
|
|
||||||
func NewGenericServerResponse(code int, verb string, qualifiedResource schema.GroupResource, name, serverMessage string, retryAfterSeconds int, isUnexpectedResponse bool) *StatusError {
|
|
||||||
reason := metav1.StatusReasonUnknown
|
|
||||||
message := fmt.Sprintf("the server responded with the status code %d but did not return more information", code)
|
|
||||||
switch code {
|
|
||||||
case http.StatusConflict:
|
|
||||||
if verb == "POST" {
|
|
||||||
reason = metav1.StatusReasonAlreadyExists
|
|
||||||
} else {
|
|
||||||
reason = metav1.StatusReasonConflict
|
|
||||||
}
|
|
||||||
message = "the server reported a conflict"
|
|
||||||
case http.StatusNotFound:
|
|
||||||
reason = metav1.StatusReasonNotFound
|
|
||||||
message = "the server could not find the requested resource"
|
|
||||||
case http.StatusBadRequest:
|
|
||||||
reason = metav1.StatusReasonBadRequest
|
|
||||||
message = "the server rejected our request for an unknown reason"
|
|
||||||
case http.StatusUnauthorized:
|
|
||||||
reason = metav1.StatusReasonUnauthorized
|
|
||||||
message = "the server has asked for the client to provide credentials"
|
|
||||||
case http.StatusForbidden:
|
|
||||||
reason = metav1.StatusReasonForbidden
|
|
||||||
// the server message has details about who is trying to perform what action. Keep its message.
|
|
||||||
message = serverMessage
|
|
||||||
case http.StatusMethodNotAllowed:
|
|
||||||
reason = metav1.StatusReasonMethodNotAllowed
|
|
||||||
message = "the server does not allow this method on the requested resource"
|
|
||||||
case StatusUnprocessableEntity:
|
|
||||||
reason = metav1.StatusReasonInvalid
|
|
||||||
message = "the server rejected our request due to an error in our request"
|
|
||||||
case StatusServerTimeout:
|
|
||||||
reason = metav1.StatusReasonServerTimeout
|
|
||||||
message = "the server cannot complete the requested operation at this time, try again later"
|
|
||||||
case StatusTooManyRequests:
|
|
||||||
reason = metav1.StatusReasonTimeout
|
|
||||||
message = "the server has received too many requests and has asked us to try again later"
|
|
||||||
default:
|
|
||||||
if code >= 500 {
|
|
||||||
reason = metav1.StatusReasonInternalError
|
|
||||||
message = fmt.Sprintf("an error on the server (%q) has prevented the request from succeeding", serverMessage)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
switch {
|
|
||||||
case !qualifiedResource.Empty() && len(name) > 0:
|
|
||||||
message = fmt.Sprintf("%s (%s %s %s)", message, strings.ToLower(verb), qualifiedResource.String(), name)
|
|
||||||
case !qualifiedResource.Empty():
|
|
||||||
message = fmt.Sprintf("%s (%s %s)", message, strings.ToLower(verb), qualifiedResource.String())
|
|
||||||
}
|
|
||||||
var causes []metav1.StatusCause
|
|
||||||
if isUnexpectedResponse {
|
|
||||||
causes = []metav1.StatusCause{
|
|
||||||
{
|
|
||||||
Type: metav1.CauseTypeUnexpectedServerResponse,
|
|
||||||
Message: serverMessage,
|
|
||||||
},
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
causes = nil
|
|
||||||
}
|
|
||||||
return &StatusError{metav1.Status{
|
|
||||||
Status: metav1.StatusFailure,
|
|
||||||
Code: int32(code),
|
|
||||||
Reason: reason,
|
|
||||||
Details: &metav1.StatusDetails{
|
|
||||||
Group: qualifiedResource.Group,
|
|
||||||
Kind: qualifiedResource.Resource,
|
|
||||||
Name: name,
|
|
||||||
|
|
||||||
Causes: causes,
|
|
||||||
RetryAfterSeconds: int32(retryAfterSeconds),
|
|
||||||
},
|
|
||||||
Message: message,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsNotFound returns true if the specified error was created by NewNotFound.
|
|
||||||
func IsNotFound(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonNotFound
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsAlreadyExists determines if the err is an error which indicates that a specified resource already exists.
|
|
||||||
func IsAlreadyExists(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonAlreadyExists
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsConflict determines if the err is an error which indicates the provided update conflicts.
|
|
||||||
func IsConflict(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonConflict
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsInvalid determines if the err is an error which indicates the provided resource is not valid.
|
|
||||||
func IsInvalid(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonInvalid
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsMethodNotSupported determines if the err is an error which indicates the provided action could not
|
|
||||||
// be performed because it is not supported by the server.
|
|
||||||
func IsMethodNotSupported(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonMethodNotAllowed
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsBadRequest determines if err is an error which indicates that the request is invalid.
|
|
||||||
func IsBadRequest(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonBadRequest
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsUnauthorized determines if err is an error which indicates that the request is unauthorized and
|
|
||||||
// requires authentication by the user.
|
|
||||||
func IsUnauthorized(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonUnauthorized
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsForbidden determines if err is an error which indicates that the request is forbidden and cannot
|
|
||||||
// be completed as requested.
|
|
||||||
func IsForbidden(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonForbidden
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsTimeout determines if err is an error which indicates that request times out due to long
|
|
||||||
// processing.
|
|
||||||
func IsTimeout(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonTimeout
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsServerTimeout determines if err is an error which indicates that the request needs to be retried
|
|
||||||
// by the client.
|
|
||||||
func IsServerTimeout(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonServerTimeout
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsInternalError determines if err is an error which indicates an internal server error.
|
|
||||||
func IsInternalError(err error) bool {
|
|
||||||
return reasonForError(err) == metav1.StatusReasonInternalError
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsTooManyRequests determines if err is an error which indicates that there are too many requests
|
|
||||||
// that the server cannot handle.
|
|
||||||
// TODO: update IsTooManyRequests() when the TooManyRequests(429) error returned from the API server has a non-empty Reason field
|
|
||||||
func IsTooManyRequests(err error) bool {
|
|
||||||
switch t := err.(type) {
|
|
||||||
case APIStatus:
|
|
||||||
return t.Status().Code == StatusTooManyRequests
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsUnexpectedServerError returns true if the server response was not in the expected API format,
|
|
||||||
// and may be the result of another HTTP actor.
|
|
||||||
func IsUnexpectedServerError(err error) bool {
|
|
||||||
switch t := err.(type) {
|
|
||||||
case APIStatus:
|
|
||||||
if d := t.Status().Details; d != nil {
|
|
||||||
for _, cause := range d.Causes {
|
|
||||||
if cause.Type == metav1.CauseTypeUnexpectedServerResponse {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsUnexpectedObjectError determines if err is due to an unexpected object from the master.
|
|
||||||
func IsUnexpectedObjectError(err error) bool {
|
|
||||||
_, ok := err.(*UnexpectedObjectError)
|
|
||||||
return err != nil && ok
|
|
||||||
}
|
|
||||||
|
|
||||||
// SuggestsClientDelay returns true if this error suggests a client delay as well as the
|
|
||||||
// suggested seconds to wait, or false if the error does not imply a wait.
|
|
||||||
func SuggestsClientDelay(err error) (int, bool) {
|
|
||||||
switch t := err.(type) {
|
|
||||||
case APIStatus:
|
|
||||||
if t.Status().Details != nil {
|
|
||||||
switch t.Status().Reason {
|
|
||||||
case metav1.StatusReasonServerTimeout, metav1.StatusReasonTimeout:
|
|
||||||
return int(t.Status().Details.RetryAfterSeconds), true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
|
|
||||||
func reasonForError(err error) metav1.StatusReason {
|
|
||||||
switch t := err.(type) {
|
|
||||||
case APIStatus:
|
|
||||||
return t.Status().Reason
|
|
||||||
}
|
|
||||||
return metav1.StatusReasonUnknown
|
|
||||||
}
|
|
||||||
@@ -1,26 +0,0 @@
|
|||||||
reviewers:
|
|
||||||
- thockin
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
- deads2k
|
|
||||||
- brendandburns
|
|
||||||
- derekwaynecarr
|
|
||||||
- caesarxuchao
|
|
||||||
- mikedanese
|
|
||||||
- liggitt
|
|
||||||
- nikhiljindal
|
|
||||||
- gmarek
|
|
||||||
- kargakis
|
|
||||||
- janetkuo
|
|
||||||
- ncdc
|
|
||||||
- eparis
|
|
||||||
- dims
|
|
||||||
- krousey
|
|
||||||
- markturansky
|
|
||||||
- fabioy
|
|
||||||
- resouer
|
|
||||||
- david-mcmahon
|
|
||||||
- mfojtik
|
|
||||||
- jianhuiz
|
|
||||||
- feihujiang
|
|
||||||
- ghodss
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/util/sets"
|
|
||||||
)
|
|
||||||
|
|
||||||
// NewDefaultRESTMapperFromScheme instantiates a DefaultRESTMapper based on types registered in the given scheme.
|
|
||||||
func NewDefaultRESTMapperFromScheme(defaultGroupVersions []schema.GroupVersion, interfacesFunc VersionInterfacesFunc,
|
|
||||||
importPathPrefix string, ignoredKinds, rootScoped sets.String, scheme *runtime.Scheme) *DefaultRESTMapper {
|
|
||||||
|
|
||||||
mapper := NewDefaultRESTMapper(defaultGroupVersions, interfacesFunc)
|
|
||||||
// enumerate all supported versions, get the kinds, and register with the mapper how to address
|
|
||||||
// our resources.
|
|
||||||
for _, gv := range defaultGroupVersions {
|
|
||||||
for kind, oType := range scheme.KnownTypes(gv) {
|
|
||||||
gvk := gv.WithKind(kind)
|
|
||||||
// TODO: Remove import path check.
|
|
||||||
// We check the import path because we currently stuff both "api" and "extensions" objects
|
|
||||||
// into the same group within Scheme since Scheme has no notion of groups yet.
|
|
||||||
if !strings.Contains(oType.PkgPath(), importPathPrefix) || ignoredKinds.Has(kind) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
scope := RESTScopeNamespace
|
|
||||||
if rootScoped.Has(kind) {
|
|
||||||
scope = RESTScopeRoot
|
|
||||||
}
|
|
||||||
mapper.Add(gvk, scope)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return mapper
|
|
||||||
}
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta provides functions for retrieving API metadata from objects
|
|
||||||
// belonging to the Kubernetes API
|
|
||||||
package meta
|
|
||||||
@@ -1,105 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// AmbiguousResourceError is returned if the RESTMapper finds multiple matches for a resource
|
|
||||||
type AmbiguousResourceError struct {
|
|
||||||
PartialResource schema.GroupVersionResource
|
|
||||||
|
|
||||||
MatchingResources []schema.GroupVersionResource
|
|
||||||
MatchingKinds []schema.GroupVersionKind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (e *AmbiguousResourceError) Error() string {
|
|
||||||
switch {
|
|
||||||
case len(e.MatchingKinds) > 0 && len(e.MatchingResources) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple resources %v and kinds %v", e.PartialResource, e.MatchingResources, e.MatchingKinds)
|
|
||||||
case len(e.MatchingKinds) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple kinds %v", e.PartialResource, e.MatchingKinds)
|
|
||||||
case len(e.MatchingResources) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple resources %v", e.PartialResource, e.MatchingResources)
|
|
||||||
}
|
|
||||||
return fmt.Sprintf("%v matches multiple resources or kinds", e.PartialResource)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AmbiguousKindError is returned if the RESTMapper finds multiple matches for a kind
|
|
||||||
type AmbiguousKindError struct {
|
|
||||||
PartialKind schema.GroupVersionKind
|
|
||||||
|
|
||||||
MatchingResources []schema.GroupVersionResource
|
|
||||||
MatchingKinds []schema.GroupVersionKind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (e *AmbiguousKindError) Error() string {
|
|
||||||
switch {
|
|
||||||
case len(e.MatchingKinds) > 0 && len(e.MatchingResources) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple resources %v and kinds %v", e.PartialKind, e.MatchingResources, e.MatchingKinds)
|
|
||||||
case len(e.MatchingKinds) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple kinds %v", e.PartialKind, e.MatchingKinds)
|
|
||||||
case len(e.MatchingResources) > 0:
|
|
||||||
return fmt.Sprintf("%v matches multiple resources %v", e.PartialKind, e.MatchingResources)
|
|
||||||
}
|
|
||||||
return fmt.Sprintf("%v matches multiple resources or kinds", e.PartialKind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func IsAmbiguousError(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
switch err.(type) {
|
|
||||||
case *AmbiguousResourceError, *AmbiguousKindError:
|
|
||||||
return true
|
|
||||||
default:
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NoResourceMatchError is returned if the RESTMapper can't find any match for a resource
|
|
||||||
type NoResourceMatchError struct {
|
|
||||||
PartialResource schema.GroupVersionResource
|
|
||||||
}
|
|
||||||
|
|
||||||
func (e *NoResourceMatchError) Error() string {
|
|
||||||
return fmt.Sprintf("no matches for %v", e.PartialResource)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NoKindMatchError is returned if the RESTMapper can't find any match for a kind
|
|
||||||
type NoKindMatchError struct {
|
|
||||||
PartialKind schema.GroupVersionKind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (e *NoKindMatchError) Error() string {
|
|
||||||
return fmt.Sprintf("no matches for %v", e.PartialKind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func IsNoMatchError(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
switch err.(type) {
|
|
||||||
case *NoResourceMatchError, *NoKindMatchError:
|
|
||||||
return true
|
|
||||||
default:
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,97 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
utilerrors "k8s.io/apimachinery/pkg/util/errors"
|
|
||||||
)
|
|
||||||
|
|
||||||
// FirstHitRESTMapper is a wrapper for multiple RESTMappers which returns the
|
|
||||||
// first successful result for the singular requests
|
|
||||||
type FirstHitRESTMapper struct {
|
|
||||||
MultiRESTMapper
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m FirstHitRESTMapper) String() string {
|
|
||||||
return fmt.Sprintf("FirstHitRESTMapper{\n\t%v\n}", m.MultiRESTMapper)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m FirstHitRESTMapper) ResourceFor(resource schema.GroupVersionResource) (schema.GroupVersionResource, error) {
|
|
||||||
errors := []error{}
|
|
||||||
for _, t := range m.MultiRESTMapper {
|
|
||||||
ret, err := t.ResourceFor(resource)
|
|
||||||
if err == nil {
|
|
||||||
return ret, nil
|
|
||||||
}
|
|
||||||
errors = append(errors, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionResource{}, collapseAggregateErrors(errors)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m FirstHitRESTMapper) KindFor(resource schema.GroupVersionResource) (schema.GroupVersionKind, error) {
|
|
||||||
errors := []error{}
|
|
||||||
for _, t := range m.MultiRESTMapper {
|
|
||||||
ret, err := t.KindFor(resource)
|
|
||||||
if err == nil {
|
|
||||||
return ret, nil
|
|
||||||
}
|
|
||||||
errors = append(errors, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionKind{}, collapseAggregateErrors(errors)
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapping provides the REST mapping for the resource based on the
|
|
||||||
// kind and version. This implementation supports multiple REST schemas and
|
|
||||||
// return the first match.
|
|
||||||
func (m FirstHitRESTMapper) RESTMapping(gk schema.GroupKind, versions ...string) (*RESTMapping, error) {
|
|
||||||
errors := []error{}
|
|
||||||
for _, t := range m.MultiRESTMapper {
|
|
||||||
ret, err := t.RESTMapping(gk, versions...)
|
|
||||||
if err == nil {
|
|
||||||
return ret, nil
|
|
||||||
}
|
|
||||||
errors = append(errors, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil, collapseAggregateErrors(errors)
|
|
||||||
}
|
|
||||||
|
|
||||||
// collapseAggregateErrors returns the minimal errors. it handles empty as nil, handles one item in a list
|
|
||||||
// by returning the item, and collapses all NoMatchErrors to a single one (since they should all be the same)
|
|
||||||
func collapseAggregateErrors(errors []error) error {
|
|
||||||
if len(errors) == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if len(errors) == 1 {
|
|
||||||
return errors[0]
|
|
||||||
}
|
|
||||||
|
|
||||||
allNoMatchErrors := true
|
|
||||||
for _, err := range errors {
|
|
||||||
allNoMatchErrors = allNoMatchErrors && IsNoMatchError(err)
|
|
||||||
}
|
|
||||||
if allNoMatchErrors {
|
|
||||||
return errors[0]
|
|
||||||
}
|
|
||||||
|
|
||||||
return utilerrors.NewAggregate(errors)
|
|
||||||
}
|
|
||||||
@@ -1,199 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
)
|
|
||||||
|
|
||||||
// IsListType returns true if the provided Object has a slice called Items
|
|
||||||
func IsListType(obj runtime.Object) bool {
|
|
||||||
// if we're a runtime.Unstructured, check whether this is a list.
|
|
||||||
// TODO: refactor GetItemsPtr to use an interface that returns []runtime.Object
|
|
||||||
if unstructured, ok := obj.(runtime.Unstructured); ok {
|
|
||||||
return unstructured.IsList()
|
|
||||||
}
|
|
||||||
|
|
||||||
_, err := GetItemsPtr(obj)
|
|
||||||
return err == nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// GetItemsPtr returns a pointer to the list object's Items member.
|
|
||||||
// If 'list' doesn't have an Items member, it's not really a list type
|
|
||||||
// and an error will be returned.
|
|
||||||
// This function will either return a pointer to a slice, or an error, but not both.
|
|
||||||
func GetItemsPtr(list runtime.Object) (interface{}, error) {
|
|
||||||
v, err := conversion.EnforcePtr(list)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
items := v.FieldByName("Items")
|
|
||||||
if !items.IsValid() {
|
|
||||||
return nil, fmt.Errorf("no Items field in %#v", list)
|
|
||||||
}
|
|
||||||
switch items.Kind() {
|
|
||||||
case reflect.Interface, reflect.Ptr:
|
|
||||||
target := reflect.TypeOf(items.Interface()).Elem()
|
|
||||||
if target.Kind() != reflect.Slice {
|
|
||||||
return nil, fmt.Errorf("items: Expected slice, got %s", target.Kind())
|
|
||||||
}
|
|
||||||
return items.Interface(), nil
|
|
||||||
case reflect.Slice:
|
|
||||||
return items.Addr().Interface(), nil
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("items: Expected slice, got %s", items.Kind())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// EachListItem invokes fn on each runtime.Object in the list. Any error immediately terminates
|
|
||||||
// the loop.
|
|
||||||
func EachListItem(obj runtime.Object, fn func(runtime.Object) error) error {
|
|
||||||
// TODO: Change to an interface call?
|
|
||||||
itemsPtr, err := GetItemsPtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
items, err := conversion.EnforcePtr(itemsPtr)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
len := items.Len()
|
|
||||||
if len == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
takeAddr := false
|
|
||||||
if elemType := items.Type().Elem(); elemType.Kind() != reflect.Ptr && elemType.Kind() != reflect.Interface {
|
|
||||||
if !items.Index(0).CanAddr() {
|
|
||||||
return fmt.Errorf("unable to take address of items in %T for EachListItem", obj)
|
|
||||||
}
|
|
||||||
takeAddr = true
|
|
||||||
}
|
|
||||||
|
|
||||||
for i := 0; i < len; i++ {
|
|
||||||
raw := items.Index(i)
|
|
||||||
if takeAddr {
|
|
||||||
raw = raw.Addr()
|
|
||||||
}
|
|
||||||
switch item := raw.Interface().(type) {
|
|
||||||
case *runtime.RawExtension:
|
|
||||||
if err := fn(item.Object); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
case runtime.Object:
|
|
||||||
if err := fn(item); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
obj, ok := item.(runtime.Object)
|
|
||||||
if !ok {
|
|
||||||
return fmt.Errorf("%v: item[%v]: Expected object, got %#v(%s)", obj, i, raw.Interface(), raw.Kind())
|
|
||||||
}
|
|
||||||
if err := fn(obj); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// ExtractList returns obj's Items element as an array of runtime.Objects.
|
|
||||||
// Returns an error if obj is not a List type (does not have an Items member).
|
|
||||||
func ExtractList(obj runtime.Object) ([]runtime.Object, error) {
|
|
||||||
itemsPtr, err := GetItemsPtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
items, err := conversion.EnforcePtr(itemsPtr)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
list := make([]runtime.Object, items.Len())
|
|
||||||
for i := range list {
|
|
||||||
raw := items.Index(i)
|
|
||||||
switch item := raw.Interface().(type) {
|
|
||||||
case runtime.RawExtension:
|
|
||||||
switch {
|
|
||||||
case item.Object != nil:
|
|
||||||
list[i] = item.Object
|
|
||||||
case item.Raw != nil:
|
|
||||||
// TODO: Set ContentEncoding and ContentType correctly.
|
|
||||||
list[i] = &runtime.Unknown{Raw: item.Raw}
|
|
||||||
default:
|
|
||||||
list[i] = nil
|
|
||||||
}
|
|
||||||
case runtime.Object:
|
|
||||||
list[i] = item
|
|
||||||
default:
|
|
||||||
var found bool
|
|
||||||
if list[i], found = raw.Addr().Interface().(runtime.Object); !found {
|
|
||||||
return nil, fmt.Errorf("%v: item[%v]: Expected object, got %#v(%s)", obj, i, raw.Interface(), raw.Kind())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return list, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// objectSliceType is the type of a slice of Objects
|
|
||||||
var objectSliceType = reflect.TypeOf([]runtime.Object{})
|
|
||||||
|
|
||||||
// SetList sets the given list object's Items member have the elements given in
|
|
||||||
// objects.
|
|
||||||
// Returns an error if list is not a List type (does not have an Items member),
|
|
||||||
// or if any of the objects are not of the right type.
|
|
||||||
func SetList(list runtime.Object, objects []runtime.Object) error {
|
|
||||||
itemsPtr, err := GetItemsPtr(list)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
items, err := conversion.EnforcePtr(itemsPtr)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if items.Type() == objectSliceType {
|
|
||||||
items.Set(reflect.ValueOf(objects))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
slice := reflect.MakeSlice(items.Type(), len(objects), len(objects))
|
|
||||||
for i := range objects {
|
|
||||||
dest := slice.Index(i)
|
|
||||||
|
|
||||||
// check to see if you're directly assignable
|
|
||||||
if reflect.TypeOf(objects[i]).AssignableTo(dest.Type()) {
|
|
||||||
dest.Set(reflect.ValueOf(objects[i]))
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
src, err := conversion.EnforcePtr(objects[i])
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if src.Type().AssignableTo(dest.Type()) {
|
|
||||||
dest.Set(src)
|
|
||||||
} else if src.Type().ConvertibleTo(dest.Type()) {
|
|
||||||
dest.Set(src.Convert(dest.Type()))
|
|
||||||
} else {
|
|
||||||
return fmt.Errorf("item[%d]: can't assign or convert %v into %v", i, src.Type(), dest.Type())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
items.Set(slice)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,147 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
)
|
|
||||||
|
|
||||||
// VersionInterfaces contains the interfaces one should use for dealing with types of a particular version.
|
|
||||||
type VersionInterfaces struct {
|
|
||||||
runtime.ObjectConvertor
|
|
||||||
MetadataAccessor
|
|
||||||
}
|
|
||||||
|
|
||||||
type ListMetaAccessor interface {
|
|
||||||
GetListMeta() List
|
|
||||||
}
|
|
||||||
|
|
||||||
// List lets you work with list metadata from any of the versioned or
|
|
||||||
// internal API objects. Attempting to set or retrieve a field on an object that does
|
|
||||||
// not support that field will be a no-op and return a default value.
|
|
||||||
type List metav1.List
|
|
||||||
|
|
||||||
// Type exposes the type and APIVersion of versioned or internal API objects.
|
|
||||||
type Type metav1.Type
|
|
||||||
|
|
||||||
// MetadataAccessor lets you work with object and list metadata from any of the versioned or
|
|
||||||
// internal API objects. Attempting to set or retrieve a field on an object that does
|
|
||||||
// not support that field (Name, UID, Namespace on lists) will be a no-op and return
|
|
||||||
// a default value.
|
|
||||||
//
|
|
||||||
// MetadataAccessor exposes Interface in a way that can be used with multiple objects.
|
|
||||||
type MetadataAccessor interface {
|
|
||||||
APIVersion(obj runtime.Object) (string, error)
|
|
||||||
SetAPIVersion(obj runtime.Object, version string) error
|
|
||||||
|
|
||||||
Kind(obj runtime.Object) (string, error)
|
|
||||||
SetKind(obj runtime.Object, kind string) error
|
|
||||||
|
|
||||||
Namespace(obj runtime.Object) (string, error)
|
|
||||||
SetNamespace(obj runtime.Object, namespace string) error
|
|
||||||
|
|
||||||
Name(obj runtime.Object) (string, error)
|
|
||||||
SetName(obj runtime.Object, name string) error
|
|
||||||
|
|
||||||
GenerateName(obj runtime.Object) (string, error)
|
|
||||||
SetGenerateName(obj runtime.Object, name string) error
|
|
||||||
|
|
||||||
UID(obj runtime.Object) (types.UID, error)
|
|
||||||
SetUID(obj runtime.Object, uid types.UID) error
|
|
||||||
|
|
||||||
SelfLink(obj runtime.Object) (string, error)
|
|
||||||
SetSelfLink(obj runtime.Object, selfLink string) error
|
|
||||||
|
|
||||||
Labels(obj runtime.Object) (map[string]string, error)
|
|
||||||
SetLabels(obj runtime.Object, labels map[string]string) error
|
|
||||||
|
|
||||||
Annotations(obj runtime.Object) (map[string]string, error)
|
|
||||||
SetAnnotations(obj runtime.Object, annotations map[string]string) error
|
|
||||||
|
|
||||||
runtime.ResourceVersioner
|
|
||||||
}
|
|
||||||
|
|
||||||
type RESTScopeName string
|
|
||||||
|
|
||||||
const (
|
|
||||||
RESTScopeNameNamespace RESTScopeName = "namespace"
|
|
||||||
RESTScopeNameRoot RESTScopeName = "root"
|
|
||||||
)
|
|
||||||
|
|
||||||
// RESTScope contains the information needed to deal with REST resources that are in a resource hierarchy
|
|
||||||
type RESTScope interface {
|
|
||||||
// Name of the scope
|
|
||||||
Name() RESTScopeName
|
|
||||||
// ParamName is the optional name of the parameter that should be inserted in the resource url
|
|
||||||
// If empty, no param will be inserted
|
|
||||||
ParamName() string
|
|
||||||
// ArgumentName is the optional name that should be used for the variable holding the value.
|
|
||||||
ArgumentName() string
|
|
||||||
// ParamDescription is the optional description to use to document the parameter in api documentation
|
|
||||||
ParamDescription() string
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapping contains the information needed to deal with objects of a specific
|
|
||||||
// resource and kind in a RESTful manner.
|
|
||||||
type RESTMapping struct {
|
|
||||||
// Resource is a string representing the name of this resource as a REST client would see it
|
|
||||||
Resource string
|
|
||||||
|
|
||||||
GroupVersionKind schema.GroupVersionKind
|
|
||||||
|
|
||||||
// Scope contains the information needed to deal with REST Resources that are in a resource hierarchy
|
|
||||||
Scope RESTScope
|
|
||||||
|
|
||||||
runtime.ObjectConvertor
|
|
||||||
MetadataAccessor
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapper allows clients to map resources to kind, and map kind and version
|
|
||||||
// to interfaces for manipulating those objects. It is primarily intended for
|
|
||||||
// consumers of Kubernetes compatible REST APIs as defined in docs/devel/api-conventions.md.
|
|
||||||
//
|
|
||||||
// The Kubernetes API provides versioned resources and object kinds which are scoped
|
|
||||||
// to API groups. In other words, kinds and resources should not be assumed to be
|
|
||||||
// unique across groups.
|
|
||||||
//
|
|
||||||
// TODO: split into sub-interfaces
|
|
||||||
type RESTMapper interface {
|
|
||||||
// KindFor takes a partial resource and returns the single match. Returns an error if there are multiple matches
|
|
||||||
KindFor(resource schema.GroupVersionResource) (schema.GroupVersionKind, error)
|
|
||||||
|
|
||||||
// KindsFor takes a partial resource and returns the list of potential kinds in priority order
|
|
||||||
KindsFor(resource schema.GroupVersionResource) ([]schema.GroupVersionKind, error)
|
|
||||||
|
|
||||||
// ResourceFor takes a partial resource and returns the single match. Returns an error if there are multiple matches
|
|
||||||
ResourceFor(input schema.GroupVersionResource) (schema.GroupVersionResource, error)
|
|
||||||
|
|
||||||
// ResourcesFor takes a partial resource and returns the list of potential resource in priority order
|
|
||||||
ResourcesFor(input schema.GroupVersionResource) ([]schema.GroupVersionResource, error)
|
|
||||||
|
|
||||||
// RESTMapping identifies a preferred resource mapping for the provided group kind.
|
|
||||||
RESTMapping(gk schema.GroupKind, versions ...string) (*RESTMapping, error)
|
|
||||||
// RESTMappings returns all resource mappings for the provided group kind if no
|
|
||||||
// version search is provided. Otherwise identifies a preferred resource mapping for
|
|
||||||
// the provided version(s).
|
|
||||||
RESTMappings(gk schema.GroupKind, versions ...string) ([]*RESTMapping, error)
|
|
||||||
|
|
||||||
AliasesForResource(resource string) ([]string, bool)
|
|
||||||
ResourceSingularizer(resource string) (singular string, err error)
|
|
||||||
}
|
|
||||||
@@ -1,567 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"github.com/golang/glog"
|
|
||||||
|
|
||||||
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
)
|
|
||||||
|
|
||||||
// errNotList is returned when an object implements the Object style interfaces but not the List style
|
|
||||||
// interfaces.
|
|
||||||
var errNotList = fmt.Errorf("object does not implement the List interfaces")
|
|
||||||
|
|
||||||
// ListAccessor returns a List interface for the provided object or an error if the object does
|
|
||||||
// not provide List.
|
|
||||||
// IMPORTANT: Objects are a superset of lists, so all Objects return List metadata. Do not use this
|
|
||||||
// check to determine whether an object *is* a List.
|
|
||||||
// TODO: return bool instead of error
|
|
||||||
func ListAccessor(obj interface{}) (List, error) {
|
|
||||||
switch t := obj.(type) {
|
|
||||||
case List:
|
|
||||||
return t, nil
|
|
||||||
case metav1.List:
|
|
||||||
return t, nil
|
|
||||||
case ListMetaAccessor:
|
|
||||||
if m := t.GetListMeta(); m != nil {
|
|
||||||
return m, nil
|
|
||||||
}
|
|
||||||
return nil, errNotList
|
|
||||||
case metav1.ListMetaAccessor:
|
|
||||||
if m := t.GetListMeta(); m != nil {
|
|
||||||
return m, nil
|
|
||||||
}
|
|
||||||
return nil, errNotList
|
|
||||||
case metav1.Object:
|
|
||||||
return t, nil
|
|
||||||
case metav1.ObjectMetaAccessor:
|
|
||||||
if m := t.GetObjectMeta(); m != nil {
|
|
||||||
return m, nil
|
|
||||||
}
|
|
||||||
return nil, errNotList
|
|
||||||
default:
|
|
||||||
return nil, errNotList
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// errNotObject is returned when an object implements the List style interfaces but not the Object style
|
|
||||||
// interfaces.
|
|
||||||
var errNotObject = fmt.Errorf("object does not implement the Object interfaces")
|
|
||||||
|
|
||||||
// Accessor takes an arbitrary object pointer and returns meta.Interface.
|
|
||||||
// obj must be a pointer to an API type. An error is returned if the minimum
|
|
||||||
// required fields are missing. Fields that are not required return the default
|
|
||||||
// value and are a no-op if set.
|
|
||||||
// TODO: return bool instead of error
|
|
||||||
func Accessor(obj interface{}) (metav1.Object, error) {
|
|
||||||
switch t := obj.(type) {
|
|
||||||
case metav1.Object:
|
|
||||||
return t, nil
|
|
||||||
case metav1.ObjectMetaAccessor:
|
|
||||||
if m := t.GetObjectMeta(); m != nil {
|
|
||||||
return m, nil
|
|
||||||
}
|
|
||||||
return nil, errNotObject
|
|
||||||
case List, metav1.List, ListMetaAccessor, metav1.ListMetaAccessor:
|
|
||||||
return nil, errNotObject
|
|
||||||
default:
|
|
||||||
return nil, errNotObject
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TypeAccessor returns an interface that allows retrieving and modifying the APIVersion
|
|
||||||
// and Kind of an in-memory internal object.
|
|
||||||
// TODO: this interface is used to test code that does not have ObjectMeta or ListMeta
|
|
||||||
// in round tripping (objects which can use apiVersion/kind, but do not fit the Kube
|
|
||||||
// api conventions).
|
|
||||||
func TypeAccessor(obj interface{}) (Type, error) {
|
|
||||||
if typed, ok := obj.(runtime.Object); ok {
|
|
||||||
return objectAccessor{typed}, nil
|
|
||||||
}
|
|
||||||
v, err := conversion.EnforcePtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
t := v.Type()
|
|
||||||
if v.Kind() != reflect.Struct {
|
|
||||||
return nil, fmt.Errorf("expected struct, but got %v: %v (%#v)", v.Kind(), t, v.Interface())
|
|
||||||
}
|
|
||||||
|
|
||||||
typeMeta := v.FieldByName("TypeMeta")
|
|
||||||
if !typeMeta.IsValid() {
|
|
||||||
return nil, fmt.Errorf("struct %v lacks embedded TypeMeta type", t)
|
|
||||||
}
|
|
||||||
a := &genericAccessor{}
|
|
||||||
if err := extractFromTypeMeta(typeMeta, a); err != nil {
|
|
||||||
return nil, fmt.Errorf("unable to find type fields on %#v: %v", typeMeta, err)
|
|
||||||
}
|
|
||||||
return a, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
type objectAccessor struct {
|
|
||||||
runtime.Object
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj objectAccessor) GetKind() string {
|
|
||||||
return obj.GetObjectKind().GroupVersionKind().Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj objectAccessor) SetKind(kind string) {
|
|
||||||
gvk := obj.GetObjectKind().GroupVersionKind()
|
|
||||||
gvk.Kind = kind
|
|
||||||
obj.GetObjectKind().SetGroupVersionKind(gvk)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj objectAccessor) GetAPIVersion() string {
|
|
||||||
return obj.GetObjectKind().GroupVersionKind().GroupVersion().String()
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj objectAccessor) SetAPIVersion(version string) {
|
|
||||||
gvk := obj.GetObjectKind().GroupVersionKind()
|
|
||||||
gv, err := schema.ParseGroupVersion(version)
|
|
||||||
if err != nil {
|
|
||||||
gv = schema.GroupVersion{Version: version}
|
|
||||||
}
|
|
||||||
gvk.Group, gvk.Version = gv.Group, gv.Version
|
|
||||||
obj.GetObjectKind().SetGroupVersionKind(gvk)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewAccessor returns a MetadataAccessor that can retrieve
|
|
||||||
// or manipulate resource version on objects derived from core API
|
|
||||||
// metadata concepts.
|
|
||||||
func NewAccessor() MetadataAccessor {
|
|
||||||
return resourceAccessor{}
|
|
||||||
}
|
|
||||||
|
|
||||||
// resourceAccessor implements ResourceVersioner and SelfLinker.
|
|
||||||
type resourceAccessor struct{}
|
|
||||||
|
|
||||||
func (resourceAccessor) Kind(obj runtime.Object) (string, error) {
|
|
||||||
return objectAccessor{obj}.GetKind(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetKind(obj runtime.Object, kind string) error {
|
|
||||||
objectAccessor{obj}.SetKind(kind)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) APIVersion(obj runtime.Object) (string, error) {
|
|
||||||
return objectAccessor{obj}.GetAPIVersion(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetAPIVersion(obj runtime.Object, version string) error {
|
|
||||||
objectAccessor{obj}.SetAPIVersion(version)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) Namespace(obj runtime.Object) (string, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetNamespace(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetNamespace(obj runtime.Object, namespace string) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetNamespace(namespace)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) Name(obj runtime.Object) (string, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetName(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetName(obj runtime.Object, name string) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetName(name)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) GenerateName(obj runtime.Object) (string, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetGenerateName(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetGenerateName(obj runtime.Object, name string) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetGenerateName(name)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) UID(obj runtime.Object) (types.UID, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetUID(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetUID(obj runtime.Object, uid types.UID) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetUID(uid)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SelfLink(obj runtime.Object) (string, error) {
|
|
||||||
accessor, err := ListAccessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetSelfLink(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetSelfLink(obj runtime.Object, selfLink string) error {
|
|
||||||
accessor, err := ListAccessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetSelfLink(selfLink)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) Labels(obj runtime.Object) (map[string]string, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return accessor.GetLabels(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetLabels(obj runtime.Object, labels map[string]string) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetLabels(labels)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) Annotations(obj runtime.Object) (map[string]string, error) {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return accessor.GetAnnotations(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetAnnotations(obj runtime.Object, annotations map[string]string) error {
|
|
||||||
accessor, err := Accessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetAnnotations(annotations)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) ResourceVersion(obj runtime.Object) (string, error) {
|
|
||||||
accessor, err := ListAccessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
return accessor.GetResourceVersion(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (resourceAccessor) SetResourceVersion(obj runtime.Object, version string) error {
|
|
||||||
accessor, err := ListAccessor(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
accessor.SetResourceVersion(version)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// extractFromOwnerReference extracts v to o. v is the OwnerReferences field of an object.
|
|
||||||
func extractFromOwnerReference(v reflect.Value, o *metav1.OwnerReference) error {
|
|
||||||
if err := runtime.Field(v, "APIVersion", &o.APIVersion); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.Field(v, "Kind", &o.Kind); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.Field(v, "Name", &o.Name); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.Field(v, "UID", &o.UID); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
var controllerPtr *bool
|
|
||||||
if err := runtime.Field(v, "Controller", &controllerPtr); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if controllerPtr != nil {
|
|
||||||
controller := *controllerPtr
|
|
||||||
o.Controller = &controller
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// setOwnerReference sets v to o. v is the OwnerReferences field of an object.
|
|
||||||
func setOwnerReference(v reflect.Value, o *metav1.OwnerReference) error {
|
|
||||||
if err := runtime.SetField(o.APIVersion, v, "APIVersion"); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.SetField(o.Kind, v, "Kind"); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.SetField(o.Name, v, "Name"); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.SetField(o.UID, v, "UID"); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if o.Controller != nil {
|
|
||||||
controller := *(o.Controller)
|
|
||||||
if err := runtime.SetField(&controller, v, "Controller"); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// genericAccessor contains pointers to strings that can modify an arbitrary
|
|
||||||
// struct and implements the Accessor interface.
|
|
||||||
type genericAccessor struct {
|
|
||||||
namespace *string
|
|
||||||
name *string
|
|
||||||
generateName *string
|
|
||||||
uid *types.UID
|
|
||||||
apiVersion *string
|
|
||||||
kind *string
|
|
||||||
resourceVersion *string
|
|
||||||
selfLink *string
|
|
||||||
creationTimestamp *metav1.Time
|
|
||||||
deletionTimestamp **metav1.Time
|
|
||||||
labels *map[string]string
|
|
||||||
annotations *map[string]string
|
|
||||||
ownerReferences reflect.Value
|
|
||||||
finalizers *[]string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetNamespace() string {
|
|
||||||
if a.namespace == nil {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
return *a.namespace
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetNamespace(namespace string) {
|
|
||||||
if a.namespace == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
*a.namespace = namespace
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetName() string {
|
|
||||||
if a.name == nil {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
return *a.name
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetName(name string) {
|
|
||||||
if a.name == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
*a.name = name
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetGenerateName() string {
|
|
||||||
if a.generateName == nil {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
return *a.generateName
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetGenerateName(generateName string) {
|
|
||||||
if a.generateName == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
*a.generateName = generateName
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetUID() types.UID {
|
|
||||||
if a.uid == nil {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
return *a.uid
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetUID(uid types.UID) {
|
|
||||||
if a.uid == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
*a.uid = uid
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetAPIVersion() string {
|
|
||||||
return *a.apiVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetAPIVersion(version string) {
|
|
||||||
*a.apiVersion = version
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetKind() string {
|
|
||||||
return *a.kind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetKind(kind string) {
|
|
||||||
*a.kind = kind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetResourceVersion() string {
|
|
||||||
return *a.resourceVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetResourceVersion(version string) {
|
|
||||||
*a.resourceVersion = version
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetSelfLink() string {
|
|
||||||
return *a.selfLink
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetSelfLink(selfLink string) {
|
|
||||||
*a.selfLink = selfLink
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetCreationTimestamp() metav1.Time {
|
|
||||||
return *a.creationTimestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetCreationTimestamp(timestamp metav1.Time) {
|
|
||||||
*a.creationTimestamp = timestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetDeletionTimestamp() *metav1.Time {
|
|
||||||
return *a.deletionTimestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetDeletionTimestamp(timestamp *metav1.Time) {
|
|
||||||
*a.deletionTimestamp = timestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetLabels() map[string]string {
|
|
||||||
if a.labels == nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return *a.labels
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetLabels(labels map[string]string) {
|
|
||||||
*a.labels = labels
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetAnnotations() map[string]string {
|
|
||||||
if a.annotations == nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return *a.annotations
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetAnnotations(annotations map[string]string) {
|
|
||||||
if a.annotations == nil {
|
|
||||||
emptyAnnotations := make(map[string]string)
|
|
||||||
a.annotations = &emptyAnnotations
|
|
||||||
}
|
|
||||||
*a.annotations = annotations
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetFinalizers() []string {
|
|
||||||
if a.finalizers == nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return *a.finalizers
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetFinalizers(finalizers []string) {
|
|
||||||
*a.finalizers = finalizers
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) GetOwnerReferences() []metav1.OwnerReference {
|
|
||||||
var ret []metav1.OwnerReference
|
|
||||||
s := a.ownerReferences
|
|
||||||
if s.Kind() != reflect.Ptr || s.Elem().Kind() != reflect.Slice {
|
|
||||||
glog.Errorf("expect %v to be a pointer to slice", s)
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
s = s.Elem()
|
|
||||||
// Set the capacity to one element greater to avoid copy if the caller later append an element.
|
|
||||||
ret = make([]metav1.OwnerReference, s.Len(), s.Len()+1)
|
|
||||||
for i := 0; i < s.Len(); i++ {
|
|
||||||
if err := extractFromOwnerReference(s.Index(i), &ret[i]); err != nil {
|
|
||||||
glog.Errorf("extractFromOwnerReference failed: %v", err)
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a genericAccessor) SetOwnerReferences(references []metav1.OwnerReference) {
|
|
||||||
s := a.ownerReferences
|
|
||||||
if s.Kind() != reflect.Ptr || s.Elem().Kind() != reflect.Slice {
|
|
||||||
glog.Errorf("expect %v to be a pointer to slice", s)
|
|
||||||
}
|
|
||||||
s = s.Elem()
|
|
||||||
newReferences := reflect.MakeSlice(s.Type(), len(references), len(references))
|
|
||||||
for i := 0; i < len(references); i++ {
|
|
||||||
if err := setOwnerReference(newReferences.Index(i), &references[i]); err != nil {
|
|
||||||
glog.Errorf("setOwnerReference failed: %v", err)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
s.Set(newReferences)
|
|
||||||
}
|
|
||||||
|
|
||||||
// extractFromTypeMeta extracts pointers to version and kind fields from an object
|
|
||||||
func extractFromTypeMeta(v reflect.Value, a *genericAccessor) error {
|
|
||||||
if err := runtime.FieldPtr(v, "APIVersion", &a.apiVersion); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := runtime.FieldPtr(v, "Kind", &a.kind); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,231 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
utilerrors "k8s.io/apimachinery/pkg/util/errors"
|
|
||||||
"k8s.io/apimachinery/pkg/util/sets"
|
|
||||||
)
|
|
||||||
|
|
||||||
// MultiRESTMapper is a wrapper for multiple RESTMappers.
|
|
||||||
type MultiRESTMapper []RESTMapper
|
|
||||||
|
|
||||||
func (m MultiRESTMapper) String() string {
|
|
||||||
nested := []string{}
|
|
||||||
for _, t := range m {
|
|
||||||
currString := fmt.Sprintf("%v", t)
|
|
||||||
splitStrings := strings.Split(currString, "\n")
|
|
||||||
nested = append(nested, strings.Join(splitStrings, "\n\t"))
|
|
||||||
}
|
|
||||||
|
|
||||||
return fmt.Sprintf("MultiRESTMapper{\n\t%s\n}", strings.Join(nested, "\n\t"))
|
|
||||||
}
|
|
||||||
|
|
||||||
// ResourceSingularizer converts a REST resource name from plural to singular (e.g., from pods to pod)
|
|
||||||
// This implementation supports multiple REST schemas and return the first match.
|
|
||||||
func (m MultiRESTMapper) ResourceSingularizer(resource string) (singular string, err error) {
|
|
||||||
for _, t := range m {
|
|
||||||
singular, err = t.ResourceSingularizer(resource)
|
|
||||||
if err == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m MultiRESTMapper) ResourcesFor(resource schema.GroupVersionResource) ([]schema.GroupVersionResource, error) {
|
|
||||||
allGVRs := []schema.GroupVersionResource{}
|
|
||||||
for _, t := range m {
|
|
||||||
gvrs, err := t.ResourcesFor(resource)
|
|
||||||
// ignore "no match" errors, but any other error percolates back up
|
|
||||||
if IsNoMatchError(err) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// walk the existing values to de-dup
|
|
||||||
for _, curr := range gvrs {
|
|
||||||
found := false
|
|
||||||
for _, existing := range allGVRs {
|
|
||||||
if curr == existing {
|
|
||||||
found = true
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if !found {
|
|
||||||
allGVRs = append(allGVRs, curr)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(allGVRs) == 0 {
|
|
||||||
return nil, &NoResourceMatchError{PartialResource: resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
return allGVRs, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m MultiRESTMapper) KindsFor(resource schema.GroupVersionResource) (gvk []schema.GroupVersionKind, err error) {
|
|
||||||
allGVKs := []schema.GroupVersionKind{}
|
|
||||||
for _, t := range m {
|
|
||||||
gvks, err := t.KindsFor(resource)
|
|
||||||
// ignore "no match" errors, but any other error percolates back up
|
|
||||||
if IsNoMatchError(err) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// walk the existing values to de-dup
|
|
||||||
for _, curr := range gvks {
|
|
||||||
found := false
|
|
||||||
for _, existing := range allGVKs {
|
|
||||||
if curr == existing {
|
|
||||||
found = true
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if !found {
|
|
||||||
allGVKs = append(allGVKs, curr)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(allGVKs) == 0 {
|
|
||||||
return nil, &NoResourceMatchError{PartialResource: resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
return allGVKs, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m MultiRESTMapper) ResourceFor(resource schema.GroupVersionResource) (schema.GroupVersionResource, error) {
|
|
||||||
resources, err := m.ResourcesFor(resource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionResource{}, err
|
|
||||||
}
|
|
||||||
if len(resources) == 1 {
|
|
||||||
return resources[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionResource{}, &AmbiguousResourceError{PartialResource: resource, MatchingResources: resources}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m MultiRESTMapper) KindFor(resource schema.GroupVersionResource) (schema.GroupVersionKind, error) {
|
|
||||||
kinds, err := m.KindsFor(resource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}, err
|
|
||||||
}
|
|
||||||
if len(kinds) == 1 {
|
|
||||||
return kinds[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionKind{}, &AmbiguousResourceError{PartialResource: resource, MatchingKinds: kinds}
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapping provides the REST mapping for the resource based on the
|
|
||||||
// kind and version. This implementation supports multiple REST schemas and
|
|
||||||
// return the first match.
|
|
||||||
func (m MultiRESTMapper) RESTMapping(gk schema.GroupKind, versions ...string) (*RESTMapping, error) {
|
|
||||||
allMappings := []*RESTMapping{}
|
|
||||||
errors := []error{}
|
|
||||||
|
|
||||||
for _, t := range m {
|
|
||||||
currMapping, err := t.RESTMapping(gk, versions...)
|
|
||||||
// ignore "no match" errors, but any other error percolates back up
|
|
||||||
if IsNoMatchError(err) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
errors = append(errors, err)
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
allMappings = append(allMappings, currMapping)
|
|
||||||
}
|
|
||||||
|
|
||||||
// if we got exactly one mapping, then use it even if other requested failed
|
|
||||||
if len(allMappings) == 1 {
|
|
||||||
return allMappings[0], nil
|
|
||||||
}
|
|
||||||
if len(allMappings) > 1 {
|
|
||||||
var kinds []schema.GroupVersionKind
|
|
||||||
for _, m := range allMappings {
|
|
||||||
kinds = append(kinds, m.GroupVersionKind)
|
|
||||||
}
|
|
||||||
return nil, &AmbiguousKindError{PartialKind: gk.WithVersion(""), MatchingKinds: kinds}
|
|
||||||
}
|
|
||||||
if len(errors) > 0 {
|
|
||||||
return nil, utilerrors.NewAggregate(errors)
|
|
||||||
}
|
|
||||||
return nil, &NoKindMatchError{PartialKind: gk.WithVersion("")}
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMappings returns all possible RESTMappings for the provided group kind, or an error
|
|
||||||
// if the type is not recognized.
|
|
||||||
func (m MultiRESTMapper) RESTMappings(gk schema.GroupKind, versions ...string) ([]*RESTMapping, error) {
|
|
||||||
var allMappings []*RESTMapping
|
|
||||||
var errors []error
|
|
||||||
|
|
||||||
for _, t := range m {
|
|
||||||
currMappings, err := t.RESTMappings(gk, versions...)
|
|
||||||
// ignore "no match" errors, but any other error percolates back up
|
|
||||||
if IsNoMatchError(err) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
errors = append(errors, err)
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
allMappings = append(allMappings, currMappings...)
|
|
||||||
}
|
|
||||||
if len(errors) > 0 {
|
|
||||||
return nil, utilerrors.NewAggregate(errors)
|
|
||||||
}
|
|
||||||
if len(allMappings) == 0 {
|
|
||||||
return nil, &NoKindMatchError{PartialKind: gk.WithVersion("")}
|
|
||||||
}
|
|
||||||
return allMappings, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AliasesForResource finds the first alias response for the provided mappers.
|
|
||||||
func (m MultiRESTMapper) AliasesForResource(alias string) ([]string, bool) {
|
|
||||||
seenAliases := sets.NewString()
|
|
||||||
allAliases := []string{}
|
|
||||||
handled := false
|
|
||||||
|
|
||||||
for _, t := range m {
|
|
||||||
if currAliases, currOk := t.AliasesForResource(alias); currOk {
|
|
||||||
for _, currAlias := range currAliases {
|
|
||||||
if !seenAliases.Has(currAlias) {
|
|
||||||
allAliases = append(allAliases, currAlias)
|
|
||||||
seenAliases.Insert(currAlias)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
handled = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return allAliases, handled
|
|
||||||
}
|
|
||||||
@@ -1,226 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
const (
|
|
||||||
AnyGroup = "*"
|
|
||||||
AnyVersion = "*"
|
|
||||||
AnyResource = "*"
|
|
||||||
AnyKind = "*"
|
|
||||||
)
|
|
||||||
|
|
||||||
// PriorityRESTMapper is a wrapper for automatically choosing a particular Resource or Kind
|
|
||||||
// when multiple matches are possible
|
|
||||||
type PriorityRESTMapper struct {
|
|
||||||
// Delegate is the RESTMapper to use to locate all the Kind and Resource matches
|
|
||||||
Delegate RESTMapper
|
|
||||||
|
|
||||||
// ResourcePriority is a list of priority patterns to apply to matching resources.
|
|
||||||
// The list of all matching resources is narrowed based on the patterns until only one remains.
|
|
||||||
// A pattern with no matches is skipped. A pattern with more than one match uses its
|
|
||||||
// matches as the list to continue matching against.
|
|
||||||
ResourcePriority []schema.GroupVersionResource
|
|
||||||
|
|
||||||
// KindPriority is a list of priority patterns to apply to matching kinds.
|
|
||||||
// The list of all matching kinds is narrowed based on the patterns until only one remains.
|
|
||||||
// A pattern with no matches is skipped. A pattern with more than one match uses its
|
|
||||||
// matches as the list to continue matching against.
|
|
||||||
KindPriority []schema.GroupVersionKind
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) String() string {
|
|
||||||
return fmt.Sprintf("PriorityRESTMapper{\n\t%v\n\t%v\n\t%v\n}", m.ResourcePriority, m.KindPriority, m.Delegate)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ResourceFor finds all resources, then passes them through the ResourcePriority patterns to find a single matching hit.
|
|
||||||
func (m PriorityRESTMapper) ResourceFor(partiallySpecifiedResource schema.GroupVersionResource) (schema.GroupVersionResource, error) {
|
|
||||||
originalGVRs, err := m.Delegate.ResourcesFor(partiallySpecifiedResource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionResource{}, err
|
|
||||||
}
|
|
||||||
if len(originalGVRs) == 1 {
|
|
||||||
return originalGVRs[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
remainingGVRs := append([]schema.GroupVersionResource{}, originalGVRs...)
|
|
||||||
for _, pattern := range m.ResourcePriority {
|
|
||||||
matchedGVRs := []schema.GroupVersionResource{}
|
|
||||||
for _, gvr := range remainingGVRs {
|
|
||||||
if resourceMatches(pattern, gvr) {
|
|
||||||
matchedGVRs = append(matchedGVRs, gvr)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
switch len(matchedGVRs) {
|
|
||||||
case 0:
|
|
||||||
// if you have no matches, then nothing matched this pattern just move to the next
|
|
||||||
continue
|
|
||||||
case 1:
|
|
||||||
// one match, return
|
|
||||||
return matchedGVRs[0], nil
|
|
||||||
default:
|
|
||||||
// more than one match, use the matched hits as the list moving to the next pattern.
|
|
||||||
// this way you can have a series of selection criteria
|
|
||||||
remainingGVRs = matchedGVRs
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionResource{}, &AmbiguousResourceError{PartialResource: partiallySpecifiedResource, MatchingResources: originalGVRs}
|
|
||||||
}
|
|
||||||
|
|
||||||
// KindFor finds all kinds, then passes them through the KindPriority patterns to find a single matching hit.
|
|
||||||
func (m PriorityRESTMapper) KindFor(partiallySpecifiedResource schema.GroupVersionResource) (schema.GroupVersionKind, error) {
|
|
||||||
originalGVKs, err := m.Delegate.KindsFor(partiallySpecifiedResource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}, err
|
|
||||||
}
|
|
||||||
if len(originalGVKs) == 1 {
|
|
||||||
return originalGVKs[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
remainingGVKs := append([]schema.GroupVersionKind{}, originalGVKs...)
|
|
||||||
for _, pattern := range m.KindPriority {
|
|
||||||
matchedGVKs := []schema.GroupVersionKind{}
|
|
||||||
for _, gvr := range remainingGVKs {
|
|
||||||
if kindMatches(pattern, gvr) {
|
|
||||||
matchedGVKs = append(matchedGVKs, gvr)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
switch len(matchedGVKs) {
|
|
||||||
case 0:
|
|
||||||
// if you have no matches, then nothing matched this pattern just move to the next
|
|
||||||
continue
|
|
||||||
case 1:
|
|
||||||
// one match, return
|
|
||||||
return matchedGVKs[0], nil
|
|
||||||
default:
|
|
||||||
// more than one match, use the matched hits as the list moving to the next pattern.
|
|
||||||
// this way you can have a series of selection criteria
|
|
||||||
remainingGVKs = matchedGVKs
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionKind{}, &AmbiguousResourceError{PartialResource: partiallySpecifiedResource, MatchingKinds: originalGVKs}
|
|
||||||
}
|
|
||||||
|
|
||||||
func resourceMatches(pattern schema.GroupVersionResource, resource schema.GroupVersionResource) bool {
|
|
||||||
if pattern.Group != AnyGroup && pattern.Group != resource.Group {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if pattern.Version != AnyVersion && pattern.Version != resource.Version {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if pattern.Resource != AnyResource && pattern.Resource != resource.Resource {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func kindMatches(pattern schema.GroupVersionKind, kind schema.GroupVersionKind) bool {
|
|
||||||
if pattern.Group != AnyGroup && pattern.Group != kind.Group {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if pattern.Version != AnyVersion && pattern.Version != kind.Version {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if pattern.Kind != AnyKind && pattern.Kind != kind.Kind {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) RESTMapping(gk schema.GroupKind, versions ...string) (mapping *RESTMapping, err error) {
|
|
||||||
mappings, err := m.Delegate.RESTMappings(gk)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// any versions the user provides take priority
|
|
||||||
priorities := m.KindPriority
|
|
||||||
if len(versions) > 0 {
|
|
||||||
priorities = make([]schema.GroupVersionKind, 0, len(m.KindPriority)+len(versions))
|
|
||||||
for _, version := range versions {
|
|
||||||
gv := schema.GroupVersion{
|
|
||||||
Version: version,
|
|
||||||
Group: gk.Group,
|
|
||||||
}
|
|
||||||
priorities = append(priorities, gv.WithKind(AnyKind))
|
|
||||||
}
|
|
||||||
priorities = append(priorities, m.KindPriority...)
|
|
||||||
}
|
|
||||||
|
|
||||||
remaining := append([]*RESTMapping{}, mappings...)
|
|
||||||
for _, pattern := range priorities {
|
|
||||||
var matching []*RESTMapping
|
|
||||||
for _, m := range remaining {
|
|
||||||
if kindMatches(pattern, m.GroupVersionKind) {
|
|
||||||
matching = append(matching, m)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
switch len(matching) {
|
|
||||||
case 0:
|
|
||||||
// if you have no matches, then nothing matched this pattern just move to the next
|
|
||||||
continue
|
|
||||||
case 1:
|
|
||||||
// one match, return
|
|
||||||
return matching[0], nil
|
|
||||||
default:
|
|
||||||
// more than one match, use the matched hits as the list moving to the next pattern.
|
|
||||||
// this way you can have a series of selection criteria
|
|
||||||
remaining = matching
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if len(remaining) == 1 {
|
|
||||||
return remaining[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
var kinds []schema.GroupVersionKind
|
|
||||||
for _, m := range mappings {
|
|
||||||
kinds = append(kinds, m.GroupVersionKind)
|
|
||||||
}
|
|
||||||
return nil, &AmbiguousKindError{PartialKind: gk.WithVersion(""), MatchingKinds: kinds}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) RESTMappings(gk schema.GroupKind, versions ...string) ([]*RESTMapping, error) {
|
|
||||||
return m.Delegate.RESTMappings(gk, versions...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) AliasesForResource(alias string) (aliases []string, ok bool) {
|
|
||||||
return m.Delegate.AliasesForResource(alias)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) ResourceSingularizer(resource string) (singular string, err error) {
|
|
||||||
return m.Delegate.ResourceSingularizer(resource)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) ResourcesFor(partiallySpecifiedResource schema.GroupVersionResource) ([]schema.GroupVersionResource, error) {
|
|
||||||
return m.Delegate.ResourcesFor(partiallySpecifiedResource)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m PriorityRESTMapper) KindsFor(partiallySpecifiedResource schema.GroupVersionResource) (gvk []schema.GroupVersionKind, err error) {
|
|
||||||
return m.Delegate.KindsFor(partiallySpecifiedResource)
|
|
||||||
}
|
|
||||||
@@ -1,566 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// TODO: move everything in this file to pkg/api/rest
|
|
||||||
package meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Implements RESTScope interface
|
|
||||||
type restScope struct {
|
|
||||||
name RESTScopeName
|
|
||||||
paramName string
|
|
||||||
argumentName string
|
|
||||||
paramDescription string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (r *restScope) Name() RESTScopeName {
|
|
||||||
return r.name
|
|
||||||
}
|
|
||||||
func (r *restScope) ParamName() string {
|
|
||||||
return r.paramName
|
|
||||||
}
|
|
||||||
func (r *restScope) ArgumentName() string {
|
|
||||||
return r.argumentName
|
|
||||||
}
|
|
||||||
func (r *restScope) ParamDescription() string {
|
|
||||||
return r.paramDescription
|
|
||||||
}
|
|
||||||
|
|
||||||
var RESTScopeNamespace = &restScope{
|
|
||||||
name: RESTScopeNameNamespace,
|
|
||||||
paramName: "namespaces",
|
|
||||||
argumentName: "namespace",
|
|
||||||
paramDescription: "object name and auth scope, such as for teams and projects",
|
|
||||||
}
|
|
||||||
|
|
||||||
var RESTScopeRoot = &restScope{
|
|
||||||
name: RESTScopeNameRoot,
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultRESTMapper exposes mappings between the types defined in a
|
|
||||||
// runtime.Scheme. It assumes that all types defined the provided scheme
|
|
||||||
// can be mapped with the provided MetadataAccessor and Codec interfaces.
|
|
||||||
//
|
|
||||||
// The resource name of a Kind is defined as the lowercase,
|
|
||||||
// English-plural version of the Kind string.
|
|
||||||
// When converting from resource to Kind, the singular version of the
|
|
||||||
// resource name is also accepted for convenience.
|
|
||||||
//
|
|
||||||
// TODO: Only accept plural for some operations for increased control?
|
|
||||||
// (`get pod bar` vs `get pods bar`)
|
|
||||||
type DefaultRESTMapper struct {
|
|
||||||
defaultGroupVersions []schema.GroupVersion
|
|
||||||
|
|
||||||
resourceToKind map[schema.GroupVersionResource]schema.GroupVersionKind
|
|
||||||
kindToPluralResource map[schema.GroupVersionKind]schema.GroupVersionResource
|
|
||||||
kindToScope map[schema.GroupVersionKind]RESTScope
|
|
||||||
singularToPlural map[schema.GroupVersionResource]schema.GroupVersionResource
|
|
||||||
pluralToSingular map[schema.GroupVersionResource]schema.GroupVersionResource
|
|
||||||
|
|
||||||
interfacesFunc VersionInterfacesFunc
|
|
||||||
|
|
||||||
// aliasToResource is used for mapping aliases to resources
|
|
||||||
aliasToResource map[string][]string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) String() string {
|
|
||||||
return fmt.Sprintf("DefaultRESTMapper{kindToPluralResource=%v}", m.kindToPluralResource)
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ RESTMapper = &DefaultRESTMapper{}
|
|
||||||
|
|
||||||
// VersionInterfacesFunc returns the appropriate typer, and metadata accessor for a
|
|
||||||
// given api version, or an error if no such api version exists.
|
|
||||||
type VersionInterfacesFunc func(version schema.GroupVersion) (*VersionInterfaces, error)
|
|
||||||
|
|
||||||
// NewDefaultRESTMapper initializes a mapping between Kind and APIVersion
|
|
||||||
// to a resource name and back based on the objects in a runtime.Scheme
|
|
||||||
// and the Kubernetes API conventions. Takes a group name, a priority list of the versions
|
|
||||||
// to search when an object has no default version (set empty to return an error),
|
|
||||||
// and a function that retrieves the correct metadata for a given version.
|
|
||||||
func NewDefaultRESTMapper(defaultGroupVersions []schema.GroupVersion, f VersionInterfacesFunc) *DefaultRESTMapper {
|
|
||||||
resourceToKind := make(map[schema.GroupVersionResource]schema.GroupVersionKind)
|
|
||||||
kindToPluralResource := make(map[schema.GroupVersionKind]schema.GroupVersionResource)
|
|
||||||
kindToScope := make(map[schema.GroupVersionKind]RESTScope)
|
|
||||||
singularToPlural := make(map[schema.GroupVersionResource]schema.GroupVersionResource)
|
|
||||||
pluralToSingular := make(map[schema.GroupVersionResource]schema.GroupVersionResource)
|
|
||||||
aliasToResource := make(map[string][]string)
|
|
||||||
// TODO: verify name mappings work correctly when versions differ
|
|
||||||
|
|
||||||
return &DefaultRESTMapper{
|
|
||||||
resourceToKind: resourceToKind,
|
|
||||||
kindToPluralResource: kindToPluralResource,
|
|
||||||
kindToScope: kindToScope,
|
|
||||||
defaultGroupVersions: defaultGroupVersions,
|
|
||||||
singularToPlural: singularToPlural,
|
|
||||||
pluralToSingular: pluralToSingular,
|
|
||||||
aliasToResource: aliasToResource,
|
|
||||||
interfacesFunc: f,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) Add(kind schema.GroupVersionKind, scope RESTScope) {
|
|
||||||
plural, singular := KindToResource(kind)
|
|
||||||
|
|
||||||
m.singularToPlural[singular] = plural
|
|
||||||
m.pluralToSingular[plural] = singular
|
|
||||||
|
|
||||||
m.resourceToKind[singular] = kind
|
|
||||||
m.resourceToKind[plural] = kind
|
|
||||||
|
|
||||||
m.kindToPluralResource[kind] = plural
|
|
||||||
m.kindToScope[kind] = scope
|
|
||||||
}
|
|
||||||
|
|
||||||
// unpluralizedSuffixes is a list of resource suffixes that are the same plural and singular
|
|
||||||
// This is only is only necessary because some bits of code are lazy and don't actually use the RESTMapper like they should.
|
|
||||||
// TODO eliminate this so that different callers can correctly map to resources. This probably means updating all
|
|
||||||
// callers to use the RESTMapper they mean.
|
|
||||||
var unpluralizedSuffixes = []string{
|
|
||||||
"endpoints",
|
|
||||||
}
|
|
||||||
|
|
||||||
// KindToResource converts Kind to a resource name.
|
|
||||||
// Broken. This method only "sort of" works when used outside of this package. It assumes that Kinds and Resources match
|
|
||||||
// and they aren't guaranteed to do so.
|
|
||||||
func KindToResource(kind schema.GroupVersionKind) ( /*plural*/ schema.GroupVersionResource /*singular*/, schema.GroupVersionResource) {
|
|
||||||
kindName := kind.Kind
|
|
||||||
if len(kindName) == 0 {
|
|
||||||
return schema.GroupVersionResource{}, schema.GroupVersionResource{}
|
|
||||||
}
|
|
||||||
singularName := strings.ToLower(kindName)
|
|
||||||
singular := kind.GroupVersion().WithResource(singularName)
|
|
||||||
|
|
||||||
for _, skip := range unpluralizedSuffixes {
|
|
||||||
if strings.HasSuffix(singularName, skip) {
|
|
||||||
return singular, singular
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
switch string(singularName[len(singularName)-1]) {
|
|
||||||
case "s":
|
|
||||||
return kind.GroupVersion().WithResource(singularName + "es"), singular
|
|
||||||
case "y":
|
|
||||||
return kind.GroupVersion().WithResource(strings.TrimSuffix(singularName, "y") + "ies"), singular
|
|
||||||
}
|
|
||||||
|
|
||||||
return kind.GroupVersion().WithResource(singularName + "s"), singular
|
|
||||||
}
|
|
||||||
|
|
||||||
// ResourceSingularizer implements RESTMapper
|
|
||||||
// It converts a resource name from plural to singular (e.g., from pods to pod)
|
|
||||||
func (m *DefaultRESTMapper) ResourceSingularizer(resourceType string) (string, error) {
|
|
||||||
partialResource := schema.GroupVersionResource{Resource: resourceType}
|
|
||||||
resources, err := m.ResourcesFor(partialResource)
|
|
||||||
if err != nil {
|
|
||||||
return resourceType, err
|
|
||||||
}
|
|
||||||
|
|
||||||
singular := schema.GroupVersionResource{}
|
|
||||||
for _, curr := range resources {
|
|
||||||
currSingular, ok := m.pluralToSingular[curr]
|
|
||||||
if !ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if singular.Empty() {
|
|
||||||
singular = currSingular
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
if currSingular.Resource != singular.Resource {
|
|
||||||
return resourceType, fmt.Errorf("multiple possible singular resources (%v) found for %v", resources, resourceType)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if singular.Empty() {
|
|
||||||
return resourceType, fmt.Errorf("no singular of resource %v has been defined", resourceType)
|
|
||||||
}
|
|
||||||
|
|
||||||
return singular.Resource, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// coerceResourceForMatching makes the resource lower case and converts internal versions to unspecified (legacy behavior)
|
|
||||||
func coerceResourceForMatching(resource schema.GroupVersionResource) schema.GroupVersionResource {
|
|
||||||
resource.Resource = strings.ToLower(resource.Resource)
|
|
||||||
if resource.Version == runtime.APIVersionInternal {
|
|
||||||
resource.Version = ""
|
|
||||||
}
|
|
||||||
|
|
||||||
return resource
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) ResourcesFor(input schema.GroupVersionResource) ([]schema.GroupVersionResource, error) {
|
|
||||||
resource := coerceResourceForMatching(input)
|
|
||||||
|
|
||||||
hasResource := len(resource.Resource) > 0
|
|
||||||
hasGroup := len(resource.Group) > 0
|
|
||||||
hasVersion := len(resource.Version) > 0
|
|
||||||
|
|
||||||
if !hasResource {
|
|
||||||
return nil, fmt.Errorf("a resource must be present, got: %v", resource)
|
|
||||||
}
|
|
||||||
|
|
||||||
ret := []schema.GroupVersionResource{}
|
|
||||||
switch {
|
|
||||||
case hasGroup && hasVersion:
|
|
||||||
// fully qualified. Find the exact match
|
|
||||||
for plural, singular := range m.pluralToSingular {
|
|
||||||
if singular == resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if plural == resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
case hasGroup:
|
|
||||||
// given a group, prefer an exact match. If you don't find one, resort to a prefix match on group
|
|
||||||
foundExactMatch := false
|
|
||||||
requestedGroupResource := resource.GroupResource()
|
|
||||||
for plural, singular := range m.pluralToSingular {
|
|
||||||
if singular.GroupResource() == requestedGroupResource {
|
|
||||||
foundExactMatch = true
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
if plural.GroupResource() == requestedGroupResource {
|
|
||||||
foundExactMatch = true
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// if you didn't find an exact match, match on group prefixing. This allows storageclass.storage to match
|
|
||||||
// storageclass.storage.k8s.io
|
|
||||||
if !foundExactMatch {
|
|
||||||
for plural, singular := range m.pluralToSingular {
|
|
||||||
if !strings.HasPrefix(plural.Group, requestedGroupResource.Group) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if singular.Resource == requestedGroupResource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
if plural.Resource == requestedGroupResource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
case hasVersion:
|
|
||||||
for plural, singular := range m.pluralToSingular {
|
|
||||||
if singular.Version == resource.Version && singular.Resource == resource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
if plural.Version == resource.Version && plural.Resource == resource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
default:
|
|
||||||
for plural, singular := range m.pluralToSingular {
|
|
||||||
if singular.Resource == resource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
if plural.Resource == resource.Resource {
|
|
||||||
ret = append(ret, plural)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(ret) == 0 {
|
|
||||||
return nil, &NoResourceMatchError{PartialResource: resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
sort.Sort(resourceByPreferredGroupVersion{ret, m.defaultGroupVersions})
|
|
||||||
return ret, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) ResourceFor(resource schema.GroupVersionResource) (schema.GroupVersionResource, error) {
|
|
||||||
resources, err := m.ResourcesFor(resource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionResource{}, err
|
|
||||||
}
|
|
||||||
if len(resources) == 1 {
|
|
||||||
return resources[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionResource{}, &AmbiguousResourceError{PartialResource: resource, MatchingResources: resources}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) KindsFor(input schema.GroupVersionResource) ([]schema.GroupVersionKind, error) {
|
|
||||||
resource := coerceResourceForMatching(input)
|
|
||||||
|
|
||||||
hasResource := len(resource.Resource) > 0
|
|
||||||
hasGroup := len(resource.Group) > 0
|
|
||||||
hasVersion := len(resource.Version) > 0
|
|
||||||
|
|
||||||
if !hasResource {
|
|
||||||
return nil, fmt.Errorf("a resource must be present, got: %v", resource)
|
|
||||||
}
|
|
||||||
|
|
||||||
ret := []schema.GroupVersionKind{}
|
|
||||||
switch {
|
|
||||||
// fully qualified. Find the exact match
|
|
||||||
case hasGroup && hasVersion:
|
|
||||||
kind, exists := m.resourceToKind[resource]
|
|
||||||
if exists {
|
|
||||||
ret = append(ret, kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
case hasGroup:
|
|
||||||
foundExactMatch := false
|
|
||||||
requestedGroupResource := resource.GroupResource()
|
|
||||||
for currResource, currKind := range m.resourceToKind {
|
|
||||||
if currResource.GroupResource() == requestedGroupResource {
|
|
||||||
foundExactMatch = true
|
|
||||||
ret = append(ret, currKind)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// if you didn't find an exact match, match on group prefixing. This allows storageclass.storage to match
|
|
||||||
// storageclass.storage.k8s.io
|
|
||||||
if !foundExactMatch {
|
|
||||||
for currResource, currKind := range m.resourceToKind {
|
|
||||||
if !strings.HasPrefix(currResource.Group, requestedGroupResource.Group) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if currResource.Resource == requestedGroupResource.Resource {
|
|
||||||
ret = append(ret, currKind)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
case hasVersion:
|
|
||||||
for currResource, currKind := range m.resourceToKind {
|
|
||||||
if currResource.Version == resource.Version && currResource.Resource == resource.Resource {
|
|
||||||
ret = append(ret, currKind)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
default:
|
|
||||||
for currResource, currKind := range m.resourceToKind {
|
|
||||||
if currResource.Resource == resource.Resource {
|
|
||||||
ret = append(ret, currKind)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(ret) == 0 {
|
|
||||||
return nil, &NoResourceMatchError{PartialResource: input}
|
|
||||||
}
|
|
||||||
|
|
||||||
sort.Sort(kindByPreferredGroupVersion{ret, m.defaultGroupVersions})
|
|
||||||
return ret, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *DefaultRESTMapper) KindFor(resource schema.GroupVersionResource) (schema.GroupVersionKind, error) {
|
|
||||||
kinds, err := m.KindsFor(resource)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}, err
|
|
||||||
}
|
|
||||||
if len(kinds) == 1 {
|
|
||||||
return kinds[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return schema.GroupVersionKind{}, &AmbiguousResourceError{PartialResource: resource, MatchingKinds: kinds}
|
|
||||||
}
|
|
||||||
|
|
||||||
type kindByPreferredGroupVersion struct {
|
|
||||||
list []schema.GroupVersionKind
|
|
||||||
sortOrder []schema.GroupVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
func (o kindByPreferredGroupVersion) Len() int { return len(o.list) }
|
|
||||||
func (o kindByPreferredGroupVersion) Swap(i, j int) { o.list[i], o.list[j] = o.list[j], o.list[i] }
|
|
||||||
func (o kindByPreferredGroupVersion) Less(i, j int) bool {
|
|
||||||
lhs := o.list[i]
|
|
||||||
rhs := o.list[j]
|
|
||||||
if lhs == rhs {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
if lhs.GroupVersion() == rhs.GroupVersion() {
|
|
||||||
return lhs.Kind < rhs.Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// otherwise, the difference is in the GroupVersion, so we need to sort with respect to the preferred order
|
|
||||||
lhsIndex := -1
|
|
||||||
rhsIndex := -1
|
|
||||||
|
|
||||||
for i := range o.sortOrder {
|
|
||||||
if o.sortOrder[i] == lhs.GroupVersion() {
|
|
||||||
lhsIndex = i
|
|
||||||
}
|
|
||||||
if o.sortOrder[i] == rhs.GroupVersion() {
|
|
||||||
rhsIndex = i
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if rhsIndex == -1 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
return lhsIndex < rhsIndex
|
|
||||||
}
|
|
||||||
|
|
||||||
type resourceByPreferredGroupVersion struct {
|
|
||||||
list []schema.GroupVersionResource
|
|
||||||
sortOrder []schema.GroupVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
func (o resourceByPreferredGroupVersion) Len() int { return len(o.list) }
|
|
||||||
func (o resourceByPreferredGroupVersion) Swap(i, j int) { o.list[i], o.list[j] = o.list[j], o.list[i] }
|
|
||||||
func (o resourceByPreferredGroupVersion) Less(i, j int) bool {
|
|
||||||
lhs := o.list[i]
|
|
||||||
rhs := o.list[j]
|
|
||||||
if lhs == rhs {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
if lhs.GroupVersion() == rhs.GroupVersion() {
|
|
||||||
return lhs.Resource < rhs.Resource
|
|
||||||
}
|
|
||||||
|
|
||||||
// otherwise, the difference is in the GroupVersion, so we need to sort with respect to the preferred order
|
|
||||||
lhsIndex := -1
|
|
||||||
rhsIndex := -1
|
|
||||||
|
|
||||||
for i := range o.sortOrder {
|
|
||||||
if o.sortOrder[i] == lhs.GroupVersion() {
|
|
||||||
lhsIndex = i
|
|
||||||
}
|
|
||||||
if o.sortOrder[i] == rhs.GroupVersion() {
|
|
||||||
rhsIndex = i
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if rhsIndex == -1 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
return lhsIndex < rhsIndex
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapping returns a struct representing the resource path and conversion interfaces a
|
|
||||||
// RESTClient should use to operate on the provided group/kind in order of versions. If a version search
|
|
||||||
// order is not provided, the search order provided to DefaultRESTMapper will be used to resolve which
|
|
||||||
// version should be used to access the named group/kind.
|
|
||||||
func (m *DefaultRESTMapper) RESTMapping(gk schema.GroupKind, versions ...string) (*RESTMapping, error) {
|
|
||||||
mappings, err := m.RESTMappings(gk, versions...)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
if len(mappings) == 0 {
|
|
||||||
return nil, &NoKindMatchError{PartialKind: gk.WithVersion("")}
|
|
||||||
}
|
|
||||||
// since we rely on RESTMappings method
|
|
||||||
// take the first match and return to the caller
|
|
||||||
// as this was the existing behavior.
|
|
||||||
return mappings[0], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMappings returns the RESTMappings for the provided group kind. If a version search order
|
|
||||||
// is not provided, the search order provided to DefaultRESTMapper will be used.
|
|
||||||
func (m *DefaultRESTMapper) RESTMappings(gk schema.GroupKind, versions ...string) ([]*RESTMapping, error) {
|
|
||||||
mappings := make([]*RESTMapping, 0)
|
|
||||||
potentialGVK := make([]schema.GroupVersionKind, 0)
|
|
||||||
hadVersion := false
|
|
||||||
|
|
||||||
// Pick an appropriate version
|
|
||||||
for _, version := range versions {
|
|
||||||
if len(version) == 0 || version == runtime.APIVersionInternal {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
currGVK := gk.WithVersion(version)
|
|
||||||
hadVersion = true
|
|
||||||
if _, ok := m.kindToPluralResource[currGVK]; ok {
|
|
||||||
potentialGVK = append(potentialGVK, currGVK)
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// Use the default preferred versions
|
|
||||||
if !hadVersion && len(potentialGVK) == 0 {
|
|
||||||
for _, gv := range m.defaultGroupVersions {
|
|
||||||
if gv.Group != gk.Group {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
potentialGVK = append(potentialGVK, gk.WithVersion(gv.Version))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(potentialGVK) == 0 {
|
|
||||||
return nil, &NoKindMatchError{PartialKind: gk.WithVersion("")}
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, gvk := range potentialGVK {
|
|
||||||
//Ensure we have a REST mapping
|
|
||||||
res, ok := m.kindToPluralResource[gvk]
|
|
||||||
if !ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// Ensure we have a REST scope
|
|
||||||
scope, ok := m.kindToScope[gvk]
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("the provided version %q and kind %q cannot be mapped to a supported scope", gvk.GroupVersion(), gvk.Kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
interfaces, err := m.interfacesFunc(gvk.GroupVersion())
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("the provided version %q has no relevant versions: %v", gvk.GroupVersion().String(), err)
|
|
||||||
}
|
|
||||||
|
|
||||||
mappings = append(mappings, &RESTMapping{
|
|
||||||
Resource: res.Resource,
|
|
||||||
GroupVersionKind: gvk,
|
|
||||||
Scope: scope,
|
|
||||||
|
|
||||||
ObjectConvertor: interfaces.ObjectConvertor,
|
|
||||||
MetadataAccessor: interfaces.MetadataAccessor,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(mappings) == 0 {
|
|
||||||
return nil, &NoResourceMatchError{PartialResource: schema.GroupVersionResource{Group: gk.Group, Resource: gk.Kind}}
|
|
||||||
}
|
|
||||||
return mappings, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddResourceAlias maps aliases to resources
|
|
||||||
func (m *DefaultRESTMapper) AddResourceAlias(alias string, resources ...string) {
|
|
||||||
if len(resources) == 0 {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
m.aliasToResource[alias] = resources
|
|
||||||
}
|
|
||||||
|
|
||||||
// AliasesForResource returns whether a resource has an alias or not
|
|
||||||
func (m *DefaultRESTMapper) AliasesForResource(alias string) ([]string, bool) {
|
|
||||||
if res, ok := m.aliasToResource[alias]; ok {
|
|
||||||
return res, true
|
|
||||||
}
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 meta
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// InterfacesForUnstructured returns VersionInterfaces suitable for
|
|
||||||
// dealing with unstructured.Unstructured objects.
|
|
||||||
func InterfacesForUnstructured(schema.GroupVersion) (*VersionInterfaces, error) {
|
|
||||||
return &VersionInterfaces{
|
|
||||||
ObjectConvertor: &unstructured.UnstructuredObjectConverter{},
|
|
||||||
MetadataAccessor: NewAccessor(),
|
|
||||||
}, nil
|
|
||||||
}
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
reviewers:
|
|
||||||
- thockin
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
- derekwaynecarr
|
|
||||||
- mikedanese
|
|
||||||
- saad-ali
|
|
||||||
- janetkuo
|
|
||||||
- timstclair
|
|
||||||
- eparis
|
|
||||||
- timothysc
|
|
||||||
- jbeda
|
|
||||||
- xiang90
|
|
||||||
- mbohlool
|
|
||||||
- david-mcmahon
|
|
||||||
- goltermann
|
|
||||||
@@ -1,298 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"math/big"
|
|
||||||
"strconv"
|
|
||||||
|
|
||||||
inf "gopkg.in/inf.v0"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Scale is used for getting and setting the base-10 scaled value.
|
|
||||||
// Base-2 scales are omitted for mathematical simplicity.
|
|
||||||
// See Quantity.ScaledValue for more details.
|
|
||||||
type Scale int32
|
|
||||||
|
|
||||||
// infScale adapts a Scale value to an inf.Scale value.
|
|
||||||
func (s Scale) infScale() inf.Scale {
|
|
||||||
return inf.Scale(-s) // inf.Scale is upside-down
|
|
||||||
}
|
|
||||||
|
|
||||||
const (
|
|
||||||
Nano Scale = -9
|
|
||||||
Micro Scale = -6
|
|
||||||
Milli Scale = -3
|
|
||||||
Kilo Scale = 3
|
|
||||||
Mega Scale = 6
|
|
||||||
Giga Scale = 9
|
|
||||||
Tera Scale = 12
|
|
||||||
Peta Scale = 15
|
|
||||||
Exa Scale = 18
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
Zero = int64Amount{}
|
|
||||||
|
|
||||||
// Used by quantity strings - treat as read only
|
|
||||||
zeroBytes = []byte("0")
|
|
||||||
)
|
|
||||||
|
|
||||||
// int64Amount represents a fixed precision numerator and arbitrary scale exponent. It is faster
|
|
||||||
// than operations on inf.Dec for values that can be represented as int64.
|
|
||||||
type int64Amount struct {
|
|
||||||
value int64
|
|
||||||
scale Scale
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sign returns 0 if the value is zero, -1 if it is less than 0, or 1 if it is greater than 0.
|
|
||||||
func (a int64Amount) Sign() int {
|
|
||||||
switch {
|
|
||||||
case a.value == 0:
|
|
||||||
return 0
|
|
||||||
case a.value > 0:
|
|
||||||
return 1
|
|
||||||
default:
|
|
||||||
return -1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsInt64 returns the current amount as an int64 at scale 0, or false if the value cannot be
|
|
||||||
// represented in an int64 OR would result in a loss of precision. This method is intended as
|
|
||||||
// an optimization to avoid calling AsDec.
|
|
||||||
func (a int64Amount) AsInt64() (int64, bool) {
|
|
||||||
if a.scale == 0 {
|
|
||||||
return a.value, true
|
|
||||||
}
|
|
||||||
if a.scale < 0 {
|
|
||||||
// TODO: attempt to reduce factors, although it is assumed that factors are reduced prior
|
|
||||||
// to the int64Amount being created.
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
return positiveScaleInt64(a.value, a.scale)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsScaledInt64 returns an int64 representing the value of this amount at the specified scale,
|
|
||||||
// rounding up, or false if that would result in overflow. (1e20).AsScaledInt64(1) would result
|
|
||||||
// in overflow because 1e19 is not representable as an int64. Note that setting a scale larger
|
|
||||||
// than the current value may result in loss of precision - i.e. (1e-6).AsScaledInt64(0) would
|
|
||||||
// return 1, because 0.000001 is rounded up to 1.
|
|
||||||
func (a int64Amount) AsScaledInt64(scale Scale) (result int64, ok bool) {
|
|
||||||
if a.scale < scale {
|
|
||||||
result, _ = negativeScaleInt64(a.value, scale-a.scale)
|
|
||||||
return result, true
|
|
||||||
}
|
|
||||||
return positiveScaleInt64(a.value, a.scale-scale)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsDec returns an inf.Dec representation of this value.
|
|
||||||
func (a int64Amount) AsDec() *inf.Dec {
|
|
||||||
var base inf.Dec
|
|
||||||
base.SetUnscaled(a.value)
|
|
||||||
base.SetScale(inf.Scale(-a.scale))
|
|
||||||
return &base
|
|
||||||
}
|
|
||||||
|
|
||||||
// Cmp returns 0 if a and b are equal, 1 if a is greater than b, or -1 if a is less than b.
|
|
||||||
func (a int64Amount) Cmp(b int64Amount) int {
|
|
||||||
switch {
|
|
||||||
case a.scale == b.scale:
|
|
||||||
// compare only the unscaled portion
|
|
||||||
case a.scale > b.scale:
|
|
||||||
result, remainder, exact := divideByScaleInt64(b.value, a.scale-b.scale)
|
|
||||||
if !exact {
|
|
||||||
return a.AsDec().Cmp(b.AsDec())
|
|
||||||
}
|
|
||||||
if result == a.value {
|
|
||||||
switch {
|
|
||||||
case remainder == 0:
|
|
||||||
return 0
|
|
||||||
case remainder > 0:
|
|
||||||
return -1
|
|
||||||
default:
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
b.value = result
|
|
||||||
default:
|
|
||||||
result, remainder, exact := divideByScaleInt64(a.value, b.scale-a.scale)
|
|
||||||
if !exact {
|
|
||||||
return a.AsDec().Cmp(b.AsDec())
|
|
||||||
}
|
|
||||||
if result == b.value {
|
|
||||||
switch {
|
|
||||||
case remainder == 0:
|
|
||||||
return 0
|
|
||||||
case remainder > 0:
|
|
||||||
return 1
|
|
||||||
default:
|
|
||||||
return -1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
a.value = result
|
|
||||||
}
|
|
||||||
|
|
||||||
switch {
|
|
||||||
case a.value == b.value:
|
|
||||||
return 0
|
|
||||||
case a.value < b.value:
|
|
||||||
return -1
|
|
||||||
default:
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add adds two int64Amounts together, matching scales. It will return false and not mutate
|
|
||||||
// a if overflow or underflow would result.
|
|
||||||
func (a *int64Amount) Add(b int64Amount) bool {
|
|
||||||
switch {
|
|
||||||
case b.value == 0:
|
|
||||||
return true
|
|
||||||
case a.value == 0:
|
|
||||||
a.value = b.value
|
|
||||||
a.scale = b.scale
|
|
||||||
return true
|
|
||||||
case a.scale == b.scale:
|
|
||||||
c, ok := int64Add(a.value, b.value)
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
a.value = c
|
|
||||||
case a.scale > b.scale:
|
|
||||||
c, ok := positiveScaleInt64(a.value, a.scale-b.scale)
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
c, ok = int64Add(c, b.value)
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
a.scale = b.scale
|
|
||||||
a.value = c
|
|
||||||
default:
|
|
||||||
c, ok := positiveScaleInt64(b.value, b.scale-a.scale)
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
c, ok = int64Add(a.value, c)
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
a.value = c
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sub removes the value of b from the current amount, or returns false if underflow would result.
|
|
||||||
func (a *int64Amount) Sub(b int64Amount) bool {
|
|
||||||
return a.Add(int64Amount{value: -b.value, scale: b.scale})
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsScale adjusts this amount to set a minimum scale, rounding up, and returns true iff no precision
|
|
||||||
// was lost. (1.1e5).AsScale(5) would return 1.1e5, but (1.1e5).AsScale(6) would return 1e6.
|
|
||||||
func (a int64Amount) AsScale(scale Scale) (int64Amount, bool) {
|
|
||||||
if a.scale >= scale {
|
|
||||||
return a, true
|
|
||||||
}
|
|
||||||
result, exact := negativeScaleInt64(a.value, scale-a.scale)
|
|
||||||
return int64Amount{value: result, scale: scale}, exact
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsCanonicalBytes accepts a buffer to write the base-10 string value of this field to, and returns
|
|
||||||
// either that buffer or a larger buffer and the current exponent of the value. The value is adjusted
|
|
||||||
// until the exponent is a multiple of 3 - i.e. 1.1e5 would return "110", 3.
|
|
||||||
func (a int64Amount) AsCanonicalBytes(out []byte) (result []byte, exponent int32) {
|
|
||||||
mantissa := a.value
|
|
||||||
exponent = int32(a.scale)
|
|
||||||
|
|
||||||
amount, times := removeInt64Factors(mantissa, 10)
|
|
||||||
exponent += int32(times)
|
|
||||||
|
|
||||||
// make sure exponent is a multiple of 3
|
|
||||||
var ok bool
|
|
||||||
switch exponent % 3 {
|
|
||||||
case 1, -2:
|
|
||||||
amount, ok = int64MultiplyScale10(amount)
|
|
||||||
if !ok {
|
|
||||||
return infDecAmount{a.AsDec()}.AsCanonicalBytes(out)
|
|
||||||
}
|
|
||||||
exponent = exponent - 1
|
|
||||||
case 2, -1:
|
|
||||||
amount, ok = int64MultiplyScale100(amount)
|
|
||||||
if !ok {
|
|
||||||
return infDecAmount{a.AsDec()}.AsCanonicalBytes(out)
|
|
||||||
}
|
|
||||||
exponent = exponent - 2
|
|
||||||
}
|
|
||||||
return strconv.AppendInt(out, amount, 10), exponent
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsCanonicalBase1024Bytes accepts a buffer to write the base-1024 string value of this field to, and returns
|
|
||||||
// either that buffer or a larger buffer and the current exponent of the value. 2048 is 2 * 1024 ^ 1 and would
|
|
||||||
// return []byte("2048"), 1.
|
|
||||||
func (a int64Amount) AsCanonicalBase1024Bytes(out []byte) (result []byte, exponent int32) {
|
|
||||||
value, ok := a.AsScaledInt64(0)
|
|
||||||
if !ok {
|
|
||||||
return infDecAmount{a.AsDec()}.AsCanonicalBase1024Bytes(out)
|
|
||||||
}
|
|
||||||
amount, exponent := removeInt64Factors(value, 1024)
|
|
||||||
return strconv.AppendInt(out, amount, 10), exponent
|
|
||||||
}
|
|
||||||
|
|
||||||
// infDecAmount implements common operations over an inf.Dec that are specific to the quantity
|
|
||||||
// representation.
|
|
||||||
type infDecAmount struct {
|
|
||||||
*inf.Dec
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsScale adjusts this amount to set a minimum scale, rounding up, and returns true iff no precision
|
|
||||||
// was lost. (1.1e5).AsScale(5) would return 1.1e5, but (1.1e5).AsScale(6) would return 1e6.
|
|
||||||
func (a infDecAmount) AsScale(scale Scale) (infDecAmount, bool) {
|
|
||||||
tmp := &inf.Dec{}
|
|
||||||
tmp.Round(a.Dec, scale.infScale(), inf.RoundUp)
|
|
||||||
return infDecAmount{tmp}, tmp.Cmp(a.Dec) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsCanonicalBytes accepts a buffer to write the base-10 string value of this field to, and returns
|
|
||||||
// either that buffer or a larger buffer and the current exponent of the value. The value is adjusted
|
|
||||||
// until the exponent is a multiple of 3 - i.e. 1.1e5 would return "110", 3.
|
|
||||||
func (a infDecAmount) AsCanonicalBytes(out []byte) (result []byte, exponent int32) {
|
|
||||||
mantissa := a.Dec.UnscaledBig()
|
|
||||||
exponent = int32(-a.Dec.Scale())
|
|
||||||
amount := big.NewInt(0).Set(mantissa)
|
|
||||||
// move all factors of 10 into the exponent for easy reasoning
|
|
||||||
amount, times := removeBigIntFactors(amount, bigTen)
|
|
||||||
exponent += times
|
|
||||||
|
|
||||||
// make sure exponent is a multiple of 3
|
|
||||||
for exponent%3 != 0 {
|
|
||||||
amount.Mul(amount, bigTen)
|
|
||||||
exponent--
|
|
||||||
}
|
|
||||||
|
|
||||||
return append(out, amount.String()...), exponent
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsCanonicalBase1024Bytes accepts a buffer to write the base-1024 string value of this field to, and returns
|
|
||||||
// either that buffer or a larger buffer and the current exponent of the value. 2048 is 2 * 1024 ^ 1 and would
|
|
||||||
// return []byte("2048"), 1.
|
|
||||||
func (a infDecAmount) AsCanonicalBase1024Bytes(out []byte) (result []byte, exponent int32) {
|
|
||||||
tmp := &inf.Dec{}
|
|
||||||
tmp.Round(a.Dec, 0, inf.RoundUp)
|
|
||||||
amount, exponent := removeBigIntFactors(tmp.UnscaledBig(), big1024)
|
|
||||||
return append(out, amount.String()...), exponent
|
|
||||||
}
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Code generated by protoc-gen-gogo.
|
|
||||||
// source: k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/api/resource/generated.proto
|
|
||||||
// DO NOT EDIT!
|
|
||||||
|
|
||||||
/*
|
|
||||||
Package resource is a generated protocol buffer package.
|
|
||||||
|
|
||||||
It is generated from these files:
|
|
||||||
k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/api/resource/generated.proto
|
|
||||||
|
|
||||||
It has these top-level messages:
|
|
||||||
Quantity
|
|
||||||
*/
|
|
||||||
package resource
|
|
||||||
|
|
||||||
import proto "github.com/gogo/protobuf/proto"
|
|
||||||
import fmt "fmt"
|
|
||||||
import math "math"
|
|
||||||
|
|
||||||
// Reference imports to suppress errors if they are not otherwise used.
|
|
||||||
var _ = proto.Marshal
|
|
||||||
var _ = fmt.Errorf
|
|
||||||
var _ = math.Inf
|
|
||||||
|
|
||||||
// This is a compile-time assertion to ensure that this generated file
|
|
||||||
// is compatible with the proto package it is being compiled against.
|
|
||||||
const _ = proto.GoGoProtoPackageIsVersion1
|
|
||||||
|
|
||||||
func (m *Quantity) Reset() { *m = Quantity{} }
|
|
||||||
func (*Quantity) ProtoMessage() {}
|
|
||||||
func (*Quantity) Descriptor() ([]byte, []int) { return fileDescriptorGenerated, []int{0} }
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
proto.RegisterType((*Quantity)(nil), "k8s.io.apimachinery.pkg.api.resource.Quantity")
|
|
||||||
}
|
|
||||||
|
|
||||||
var fileDescriptorGenerated = []byte{
|
|
||||||
// 253 bytes of a gzipped FileDescriptorProto
|
|
||||||
0x1f, 0x8b, 0x08, 0x00, 0x00, 0x09, 0x6e, 0x88, 0x02, 0xff, 0x74, 0x8f, 0xb1, 0x4a, 0x03, 0x41,
|
|
||||||
0x10, 0x86, 0x77, 0x1b, 0x89, 0x57, 0x06, 0x11, 0x49, 0xb1, 0x17, 0xc4, 0x42, 0x04, 0x77, 0x0a,
|
|
||||||
0x9b, 0x60, 0x69, 0x6f, 0xa1, 0xa5, 0xdd, 0xdd, 0x65, 0xdc, 0x2c, 0x67, 0x76, 0x8f, 0xd9, 0x59,
|
|
||||||
0x21, 0x5d, 0x4a, 0xcb, 0x94, 0x96, 0xb9, 0xb7, 0x49, 0x99, 0xd2, 0xc2, 0xc2, 0x3b, 0x5f, 0x44,
|
|
||||||
0x72, 0xc9, 0x81, 0x08, 0x76, 0xf3, 0xfd, 0xc3, 0x37, 0xfc, 0x93, 0xdc, 0x97, 0x93, 0xa0, 0xad,
|
|
||||||
0x87, 0x32, 0xe6, 0x48, 0x0e, 0x19, 0x03, 0xbc, 0xa2, 0x9b, 0x7a, 0x82, 0xc3, 0x22, 0xab, 0xec,
|
|
||||||
0x3c, 0x2b, 0x66, 0xd6, 0x21, 0x2d, 0xa0, 0x2a, 0xcd, 0x2e, 0x00, 0xc2, 0xe0, 0x23, 0x15, 0x08,
|
|
||||||
0x06, 0x1d, 0x52, 0xc6, 0x38, 0xd5, 0x15, 0x79, 0xf6, 0xc3, 0x8b, 0xbd, 0xa5, 0x7f, 0x5b, 0xba,
|
|
||||||
0x2a, 0xcd, 0x2e, 0xd0, 0xbd, 0x35, 0xba, 0x36, 0x96, 0x67, 0x31, 0xd7, 0x85, 0x9f, 0x83, 0xf1,
|
|
||||||
0xc6, 0x43, 0x27, 0xe7, 0xf1, 0xb9, 0xa3, 0x0e, 0xba, 0x69, 0x7f, 0x74, 0x74, 0xf3, 0x5f, 0x95,
|
|
||||||
0xc8, 0xf6, 0x05, 0xac, 0xe3, 0xc0, 0xf4, 0xb7, 0xc9, 0xf9, 0x24, 0x19, 0x3c, 0xc4, 0xcc, 0xb1,
|
|
||||||
0xe5, 0xc5, 0xf0, 0x34, 0x39, 0x0a, 0x4c, 0xd6, 0x99, 0x33, 0x39, 0x96, 0x97, 0xc7, 0x8f, 0x07,
|
|
||||||
0xba, 0x3d, 0x79, 0x5f, 0xa7, 0xe2, 0xad, 0x4e, 0xc5, 0xaa, 0x4e, 0xc5, 0xba, 0x4e, 0xc5, 0xf2,
|
|
||||||
0x73, 0x2c, 0xee, 0xae, 0x36, 0x8d, 0x12, 0xdb, 0x46, 0x89, 0x8f, 0x46, 0x89, 0x65, 0xab, 0xe4,
|
|
||||||
0xa6, 0x55, 0x72, 0xdb, 0x2a, 0xf9, 0xd5, 0x2a, 0xb9, 0xfa, 0x56, 0xe2, 0x69, 0xd0, 0x7f, 0xf2,
|
|
||||||
0x13, 0x00, 0x00, 0xff, 0xff, 0xdf, 0x3c, 0xf3, 0xc9, 0x3f, 0x01, 0x00, 0x00,
|
|
||||||
}
|
|
||||||
@@ -1,94 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
|
|
||||||
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
|
|
||||||
|
|
||||||
syntax = 'proto2';
|
|
||||||
|
|
||||||
package k8s.io.apimachinery.pkg.api.resource;
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
|
|
||||||
|
|
||||||
// Package-wide variables from generator "generated".
|
|
||||||
option go_package = "resource";
|
|
||||||
|
|
||||||
// Quantity is a fixed-point representation of a number.
|
|
||||||
// It provides convenient marshaling/unmarshaling in JSON and YAML,
|
|
||||||
// in addition to String() and Int64() accessors.
|
|
||||||
//
|
|
||||||
// The serialization format is:
|
|
||||||
//
|
|
||||||
// <quantity> ::= <signedNumber><suffix>
|
|
||||||
// (Note that <suffix> may be empty, from the "" case in <decimalSI>.)
|
|
||||||
// <digit> ::= 0 | 1 | ... | 9
|
|
||||||
// <digits> ::= <digit> | <digit><digits>
|
|
||||||
// <number> ::= <digits> | <digits>.<digits> | <digits>. | .<digits>
|
|
||||||
// <sign> ::= "+" | "-"
|
|
||||||
// <signedNumber> ::= <number> | <sign><number>
|
|
||||||
// <suffix> ::= <binarySI> | <decimalExponent> | <decimalSI>
|
|
||||||
// <binarySI> ::= Ki | Mi | Gi | Ti | Pi | Ei
|
|
||||||
// (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html)
|
|
||||||
// <decimalSI> ::= m | "" | k | M | G | T | P | E
|
|
||||||
// (Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.)
|
|
||||||
// <decimalExponent> ::= "e" <signedNumber> | "E" <signedNumber>
|
|
||||||
//
|
|
||||||
// No matter which of the three exponent forms is used, no quantity may represent
|
|
||||||
// a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal
|
|
||||||
// places. Numbers larger or more precise will be capped or rounded up.
|
|
||||||
// (E.g.: 0.1m will rounded up to 1m.)
|
|
||||||
// This may be extended in the future if we require larger or smaller quantities.
|
|
||||||
//
|
|
||||||
// When a Quantity is parsed from a string, it will remember the type of suffix
|
|
||||||
// it had, and will use the same type again when it is serialized.
|
|
||||||
//
|
|
||||||
// Before serializing, Quantity will be put in "canonical form".
|
|
||||||
// This means that Exponent/suffix will be adjusted up or down (with a
|
|
||||||
// corresponding increase or decrease in Mantissa) such that:
|
|
||||||
// a. No precision is lost
|
|
||||||
// b. No fractional digits will be emitted
|
|
||||||
// c. The exponent (or suffix) is as large as possible.
|
|
||||||
// The sign will be omitted unless the number is negative.
|
|
||||||
//
|
|
||||||
// Examples:
|
|
||||||
// 1.5 will be serialized as "1500m"
|
|
||||||
// 1.5Gi will be serialized as "1536Mi"
|
|
||||||
//
|
|
||||||
// NOTE: We reserve the right to amend this canonical format, perhaps to
|
|
||||||
// allow 1.5 to be canonical.
|
|
||||||
// TODO: Remove above disclaimer after all bikeshedding about format is over,
|
|
||||||
// or after March 2015.
|
|
||||||
//
|
|
||||||
// Note that the quantity will NEVER be internally represented by a
|
|
||||||
// floating point number. That is the whole point of this exercise.
|
|
||||||
//
|
|
||||||
// Non-canonical values will still parse as long as they are well formed,
|
|
||||||
// but will be re-emitted in their canonical form. (So always use canonical
|
|
||||||
// form, or don't diff.)
|
|
||||||
//
|
|
||||||
// This format is intended to make it difficult to use these numbers without
|
|
||||||
// writing some sort of special handling code in the hopes that that will
|
|
||||||
// cause implementors to also use a fixed point implementation.
|
|
||||||
//
|
|
||||||
// +protobuf=true
|
|
||||||
// +protobuf.embed=string
|
|
||||||
// +protobuf.options.marshal=false
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
// +k8s:openapi-gen=true
|
|
||||||
message Quantity {
|
|
||||||
optional string string = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
@@ -1,327 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"math/big"
|
|
||||||
|
|
||||||
inf "gopkg.in/inf.v0"
|
|
||||||
)
|
|
||||||
|
|
||||||
const (
|
|
||||||
// maxInt64Factors is the highest value that will be checked when removing factors of 10 from an int64.
|
|
||||||
// It is also the maximum decimal digits that can be represented with an int64.
|
|
||||||
maxInt64Factors = 18
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
// Commonly needed big.Int values-- treat as read only!
|
|
||||||
bigTen = big.NewInt(10)
|
|
||||||
bigZero = big.NewInt(0)
|
|
||||||
bigOne = big.NewInt(1)
|
|
||||||
bigThousand = big.NewInt(1000)
|
|
||||||
big1024 = big.NewInt(1024)
|
|
||||||
|
|
||||||
// Commonly needed inf.Dec values-- treat as read only!
|
|
||||||
decZero = inf.NewDec(0, 0)
|
|
||||||
decOne = inf.NewDec(1, 0)
|
|
||||||
decMinusOne = inf.NewDec(-1, 0)
|
|
||||||
decThousand = inf.NewDec(1000, 0)
|
|
||||||
dec1024 = inf.NewDec(1024, 0)
|
|
||||||
decMinus1024 = inf.NewDec(-1024, 0)
|
|
||||||
|
|
||||||
// Largest (in magnitude) number allowed.
|
|
||||||
maxAllowed = infDecAmount{inf.NewDec((1<<63)-1, 0)} // == max int64
|
|
||||||
|
|
||||||
// The maximum value we can represent milli-units for.
|
|
||||||
// Compare with the return value of Quantity.Value() to
|
|
||||||
// see if it's safe to use Quantity.MilliValue().
|
|
||||||
MaxMilliValue = int64(((1 << 63) - 1) / 1000)
|
|
||||||
)
|
|
||||||
|
|
||||||
const mostNegative = -(mostPositive + 1)
|
|
||||||
const mostPositive = 1<<63 - 1
|
|
||||||
|
|
||||||
// int64Add returns a+b, or false if that would overflow int64.
|
|
||||||
func int64Add(a, b int64) (int64, bool) {
|
|
||||||
c := a + b
|
|
||||||
switch {
|
|
||||||
case a > 0 && b > 0:
|
|
||||||
if c < 0 {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
case a < 0 && b < 0:
|
|
||||||
if c > 0 {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
if a == mostNegative && b == mostNegative {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return c, true
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64Multiply returns a*b, or false if that would overflow or underflow int64.
|
|
||||||
func int64Multiply(a, b int64) (int64, bool) {
|
|
||||||
if a == 0 || b == 0 || a == 1 || b == 1 {
|
|
||||||
return a * b, true
|
|
||||||
}
|
|
||||||
if a == mostNegative || b == mostNegative {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
c := a * b
|
|
||||||
return c, c/b == a
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64MultiplyScale returns a*b, assuming b is greater than one, or false if that would overflow or underflow int64.
|
|
||||||
// Use when b is known to be greater than one.
|
|
||||||
func int64MultiplyScale(a int64, b int64) (int64, bool) {
|
|
||||||
if a == 0 || a == 1 {
|
|
||||||
return a * b, true
|
|
||||||
}
|
|
||||||
if a == mostNegative && b != 1 {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
c := a * b
|
|
||||||
return c, c/b == a
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64MultiplyScale10 multiplies a by 10, or returns false if that would overflow. This method is faster than
|
|
||||||
// int64Multiply(a, 10) because the compiler can optimize constant factor multiplication.
|
|
||||||
func int64MultiplyScale10(a int64) (int64, bool) {
|
|
||||||
if a == 0 || a == 1 {
|
|
||||||
return a * 10, true
|
|
||||||
}
|
|
||||||
if a == mostNegative {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
c := a * 10
|
|
||||||
return c, c/10 == a
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64MultiplyScale100 multiplies a by 100, or returns false if that would overflow. This method is faster than
|
|
||||||
// int64Multiply(a, 100) because the compiler can optimize constant factor multiplication.
|
|
||||||
func int64MultiplyScale100(a int64) (int64, bool) {
|
|
||||||
if a == 0 || a == 1 {
|
|
||||||
return a * 100, true
|
|
||||||
}
|
|
||||||
if a == mostNegative {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
c := a * 100
|
|
||||||
return c, c/100 == a
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64MultiplyScale1000 multiplies a by 1000, or returns false if that would overflow. This method is faster than
|
|
||||||
// int64Multiply(a, 1000) because the compiler can optimize constant factor multiplication.
|
|
||||||
func int64MultiplyScale1000(a int64) (int64, bool) {
|
|
||||||
if a == 0 || a == 1 {
|
|
||||||
return a * 1000, true
|
|
||||||
}
|
|
||||||
if a == mostNegative {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
c := a * 1000
|
|
||||||
return c, c/1000 == a
|
|
||||||
}
|
|
||||||
|
|
||||||
// positiveScaleInt64 multiplies base by 10^scale, returning false if the
|
|
||||||
// value overflows. Passing a negative scale is undefined.
|
|
||||||
func positiveScaleInt64(base int64, scale Scale) (int64, bool) {
|
|
||||||
switch scale {
|
|
||||||
case 0:
|
|
||||||
return base, true
|
|
||||||
case 1:
|
|
||||||
return int64MultiplyScale10(base)
|
|
||||||
case 2:
|
|
||||||
return int64MultiplyScale100(base)
|
|
||||||
case 3:
|
|
||||||
return int64MultiplyScale1000(base)
|
|
||||||
case 6:
|
|
||||||
return int64MultiplyScale(base, 1000000)
|
|
||||||
case 9:
|
|
||||||
return int64MultiplyScale(base, 1000000000)
|
|
||||||
default:
|
|
||||||
value := base
|
|
||||||
var ok bool
|
|
||||||
for i := Scale(0); i < scale; i++ {
|
|
||||||
if value, ok = int64MultiplyScale(value, 10); !ok {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return value, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// negativeScaleInt64 reduces base by the provided scale, rounding up, until the
|
|
||||||
// value is zero or the scale is reached. Passing a negative scale is undefined.
|
|
||||||
// The value returned, if not exact, is rounded away from zero.
|
|
||||||
func negativeScaleInt64(base int64, scale Scale) (result int64, exact bool) {
|
|
||||||
if scale == 0 {
|
|
||||||
return base, true
|
|
||||||
}
|
|
||||||
|
|
||||||
value := base
|
|
||||||
var fraction bool
|
|
||||||
for i := Scale(0); i < scale; i++ {
|
|
||||||
if !fraction && value%10 != 0 {
|
|
||||||
fraction = true
|
|
||||||
}
|
|
||||||
value = value / 10
|
|
||||||
if value == 0 {
|
|
||||||
if fraction {
|
|
||||||
if base > 0 {
|
|
||||||
return 1, false
|
|
||||||
}
|
|
||||||
return -1, false
|
|
||||||
}
|
|
||||||
return 0, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if fraction {
|
|
||||||
if base > 0 {
|
|
||||||
value += 1
|
|
||||||
} else {
|
|
||||||
value += -1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return value, !fraction
|
|
||||||
}
|
|
||||||
|
|
||||||
func pow10Int64(b int64) int64 {
|
|
||||||
switch b {
|
|
||||||
case 0:
|
|
||||||
return 1
|
|
||||||
case 1:
|
|
||||||
return 10
|
|
||||||
case 2:
|
|
||||||
return 100
|
|
||||||
case 3:
|
|
||||||
return 1000
|
|
||||||
case 4:
|
|
||||||
return 10000
|
|
||||||
case 5:
|
|
||||||
return 100000
|
|
||||||
case 6:
|
|
||||||
return 1000000
|
|
||||||
case 7:
|
|
||||||
return 10000000
|
|
||||||
case 8:
|
|
||||||
return 100000000
|
|
||||||
case 9:
|
|
||||||
return 1000000000
|
|
||||||
case 10:
|
|
||||||
return 10000000000
|
|
||||||
case 11:
|
|
||||||
return 100000000000
|
|
||||||
case 12:
|
|
||||||
return 1000000000000
|
|
||||||
case 13:
|
|
||||||
return 10000000000000
|
|
||||||
case 14:
|
|
||||||
return 100000000000000
|
|
||||||
case 15:
|
|
||||||
return 1000000000000000
|
|
||||||
case 16:
|
|
||||||
return 10000000000000000
|
|
||||||
case 17:
|
|
||||||
return 100000000000000000
|
|
||||||
case 18:
|
|
||||||
return 1000000000000000000
|
|
||||||
default:
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// powInt64 raises a to the bth power. Is not overflow aware.
|
|
||||||
func powInt64(a, b int64) int64 {
|
|
||||||
p := int64(1)
|
|
||||||
for b > 0 {
|
|
||||||
if b&1 != 0 {
|
|
||||||
p *= a
|
|
||||||
}
|
|
||||||
b >>= 1
|
|
||||||
a *= a
|
|
||||||
}
|
|
||||||
return p
|
|
||||||
}
|
|
||||||
|
|
||||||
// negativeScaleInt64 returns the result of dividing base by scale * 10 and the remainder, or
|
|
||||||
// false if no such division is possible. Dividing by negative scales is undefined.
|
|
||||||
func divideByScaleInt64(base int64, scale Scale) (result, remainder int64, exact bool) {
|
|
||||||
if scale == 0 {
|
|
||||||
return base, 0, true
|
|
||||||
}
|
|
||||||
// the max scale representable in base 10 in an int64 is 18 decimal places
|
|
||||||
if scale >= 18 {
|
|
||||||
return 0, base, false
|
|
||||||
}
|
|
||||||
divisor := pow10Int64(int64(scale))
|
|
||||||
return base / divisor, base % divisor, true
|
|
||||||
}
|
|
||||||
|
|
||||||
// removeInt64Factors divides in a loop; the return values have the property that
|
|
||||||
// value == result * base ^ scale
|
|
||||||
func removeInt64Factors(value int64, base int64) (result int64, times int32) {
|
|
||||||
times = 0
|
|
||||||
result = value
|
|
||||||
negative := result < 0
|
|
||||||
if negative {
|
|
||||||
result = -result
|
|
||||||
}
|
|
||||||
switch base {
|
|
||||||
// allow the compiler to optimize the common cases
|
|
||||||
case 10:
|
|
||||||
for result >= 10 && result%10 == 0 {
|
|
||||||
times++
|
|
||||||
result = result / 10
|
|
||||||
}
|
|
||||||
// allow the compiler to optimize the common cases
|
|
||||||
case 1024:
|
|
||||||
for result >= 1024 && result%1024 == 0 {
|
|
||||||
times++
|
|
||||||
result = result / 1024
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
for result >= base && result%base == 0 {
|
|
||||||
times++
|
|
||||||
result = result / base
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if negative {
|
|
||||||
result = -result
|
|
||||||
}
|
|
||||||
return result, times
|
|
||||||
}
|
|
||||||
|
|
||||||
// removeBigIntFactors divides in a loop; the return values have the property that
|
|
||||||
// d == result * factor ^ times
|
|
||||||
// d may be modified in place.
|
|
||||||
// If d == 0, then the return values will be (0, 0)
|
|
||||||
func removeBigIntFactors(d, factor *big.Int) (result *big.Int, times int32) {
|
|
||||||
q := big.NewInt(0)
|
|
||||||
m := big.NewInt(0)
|
|
||||||
for d.Cmp(bigZero) != 0 {
|
|
||||||
q.DivMod(d, factor, m)
|
|
||||||
if m.Cmp(bigZero) != 0 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
times++
|
|
||||||
d, q = q, d
|
|
||||||
}
|
|
||||||
return d, times
|
|
||||||
}
|
|
||||||
@@ -1,791 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"math/big"
|
|
||||||
"regexp"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
flag "github.com/spf13/pflag"
|
|
||||||
|
|
||||||
"github.com/go-openapi/spec"
|
|
||||||
inf "gopkg.in/inf.v0"
|
|
||||||
"k8s.io/apimachinery/pkg/openapi"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Quantity is a fixed-point representation of a number.
|
|
||||||
// It provides convenient marshaling/unmarshaling in JSON and YAML,
|
|
||||||
// in addition to String() and Int64() accessors.
|
|
||||||
//
|
|
||||||
// The serialization format is:
|
|
||||||
//
|
|
||||||
// <quantity> ::= <signedNumber><suffix>
|
|
||||||
// (Note that <suffix> may be empty, from the "" case in <decimalSI>.)
|
|
||||||
// <digit> ::= 0 | 1 | ... | 9
|
|
||||||
// <digits> ::= <digit> | <digit><digits>
|
|
||||||
// <number> ::= <digits> | <digits>.<digits> | <digits>. | .<digits>
|
|
||||||
// <sign> ::= "+" | "-"
|
|
||||||
// <signedNumber> ::= <number> | <sign><number>
|
|
||||||
// <suffix> ::= <binarySI> | <decimalExponent> | <decimalSI>
|
|
||||||
// <binarySI> ::= Ki | Mi | Gi | Ti | Pi | Ei
|
|
||||||
// (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html)
|
|
||||||
// <decimalSI> ::= m | "" | k | M | G | T | P | E
|
|
||||||
// (Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.)
|
|
||||||
// <decimalExponent> ::= "e" <signedNumber> | "E" <signedNumber>
|
|
||||||
//
|
|
||||||
// No matter which of the three exponent forms is used, no quantity may represent
|
|
||||||
// a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal
|
|
||||||
// places. Numbers larger or more precise will be capped or rounded up.
|
|
||||||
// (E.g.: 0.1m will rounded up to 1m.)
|
|
||||||
// This may be extended in the future if we require larger or smaller quantities.
|
|
||||||
//
|
|
||||||
// When a Quantity is parsed from a string, it will remember the type of suffix
|
|
||||||
// it had, and will use the same type again when it is serialized.
|
|
||||||
//
|
|
||||||
// Before serializing, Quantity will be put in "canonical form".
|
|
||||||
// This means that Exponent/suffix will be adjusted up or down (with a
|
|
||||||
// corresponding increase or decrease in Mantissa) such that:
|
|
||||||
// a. No precision is lost
|
|
||||||
// b. No fractional digits will be emitted
|
|
||||||
// c. The exponent (or suffix) is as large as possible.
|
|
||||||
// The sign will be omitted unless the number is negative.
|
|
||||||
//
|
|
||||||
// Examples:
|
|
||||||
// 1.5 will be serialized as "1500m"
|
|
||||||
// 1.5Gi will be serialized as "1536Mi"
|
|
||||||
//
|
|
||||||
// NOTE: We reserve the right to amend this canonical format, perhaps to
|
|
||||||
// allow 1.5 to be canonical.
|
|
||||||
// TODO: Remove above disclaimer after all bikeshedding about format is over,
|
|
||||||
// or after March 2015.
|
|
||||||
//
|
|
||||||
// Note that the quantity will NEVER be internally represented by a
|
|
||||||
// floating point number. That is the whole point of this exercise.
|
|
||||||
//
|
|
||||||
// Non-canonical values will still parse as long as they are well formed,
|
|
||||||
// but will be re-emitted in their canonical form. (So always use canonical
|
|
||||||
// form, or don't diff.)
|
|
||||||
//
|
|
||||||
// This format is intended to make it difficult to use these numbers without
|
|
||||||
// writing some sort of special handling code in the hopes that that will
|
|
||||||
// cause implementors to also use a fixed point implementation.
|
|
||||||
//
|
|
||||||
// +protobuf=true
|
|
||||||
// +protobuf.embed=string
|
|
||||||
// +protobuf.options.marshal=false
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type Quantity struct {
|
|
||||||
// i is the quantity in int64 scaled form, if d.Dec == nil
|
|
||||||
i int64Amount
|
|
||||||
// d is the quantity in inf.Dec form if d.Dec != nil
|
|
||||||
d infDecAmount
|
|
||||||
// s is the generated value of this quantity to avoid recalculation
|
|
||||||
s string
|
|
||||||
|
|
||||||
// Change Format at will. See the comment for Canonicalize for
|
|
||||||
// more details.
|
|
||||||
Format
|
|
||||||
}
|
|
||||||
|
|
||||||
// CanonicalValue allows a quantity amount to be converted to a string.
|
|
||||||
type CanonicalValue interface {
|
|
||||||
// AsCanonicalBytes returns a byte array representing the string representation
|
|
||||||
// of the value mantissa and an int32 representing its exponent in base-10. Callers may
|
|
||||||
// pass a byte slice to the method to avoid allocations.
|
|
||||||
AsCanonicalBytes(out []byte) ([]byte, int32)
|
|
||||||
// AsCanonicalBase1024Bytes returns a byte array representing the string representation
|
|
||||||
// of the value mantissa and an int32 representing its exponent in base-1024. Callers
|
|
||||||
// may pass a byte slice to the method to avoid allocations.
|
|
||||||
AsCanonicalBase1024Bytes(out []byte) ([]byte, int32)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Format lists the three possible formattings of a quantity.
|
|
||||||
type Format string
|
|
||||||
|
|
||||||
const (
|
|
||||||
DecimalExponent = Format("DecimalExponent") // e.g., 12e6
|
|
||||||
BinarySI = Format("BinarySI") // e.g., 12Mi (12 * 2^20)
|
|
||||||
DecimalSI = Format("DecimalSI") // e.g., 12M (12 * 10^6)
|
|
||||||
)
|
|
||||||
|
|
||||||
// MustParse turns the given string into a quantity or panics; for tests
|
|
||||||
// or others cases where you know the string is valid.
|
|
||||||
func MustParse(str string) Quantity {
|
|
||||||
q, err := ParseQuantity(str)
|
|
||||||
if err != nil {
|
|
||||||
panic(fmt.Errorf("cannot parse '%v': %v", str, err))
|
|
||||||
}
|
|
||||||
return q
|
|
||||||
}
|
|
||||||
|
|
||||||
const (
|
|
||||||
// splitREString is used to separate a number from its suffix; as such,
|
|
||||||
// this is overly permissive, but that's OK-- it will be checked later.
|
|
||||||
splitREString = "^([+-]?[0-9.]+)([eEinumkKMGTP]*[-+]?[0-9]*)$"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
// splitRE is used to get the various parts of a number.
|
|
||||||
splitRE = regexp.MustCompile(splitREString)
|
|
||||||
|
|
||||||
// Errors that could happen while parsing a string.
|
|
||||||
ErrFormatWrong = errors.New("quantities must match the regular expression '" + splitREString + "'")
|
|
||||||
ErrNumeric = errors.New("unable to parse numeric part of quantity")
|
|
||||||
ErrSuffix = errors.New("unable to parse quantity's suffix")
|
|
||||||
)
|
|
||||||
|
|
||||||
// parseQuantityString is a fast scanner for quantity values.
|
|
||||||
func parseQuantityString(str string) (positive bool, value, num, denom, suffix string, err error) {
|
|
||||||
positive = true
|
|
||||||
pos := 0
|
|
||||||
end := len(str)
|
|
||||||
|
|
||||||
// handle leading sign
|
|
||||||
if pos < end {
|
|
||||||
switch str[0] {
|
|
||||||
case '-':
|
|
||||||
positive = false
|
|
||||||
pos++
|
|
||||||
case '+':
|
|
||||||
pos++
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// strip leading zeros
|
|
||||||
Zeroes:
|
|
||||||
for i := pos; ; i++ {
|
|
||||||
if i >= end {
|
|
||||||
num = "0"
|
|
||||||
value = num
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch str[i] {
|
|
||||||
case '0':
|
|
||||||
pos++
|
|
||||||
default:
|
|
||||||
break Zeroes
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// extract the numerator
|
|
||||||
Num:
|
|
||||||
for i := pos; ; i++ {
|
|
||||||
if i >= end {
|
|
||||||
num = str[pos:end]
|
|
||||||
value = str[0:end]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch str[i] {
|
|
||||||
case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9':
|
|
||||||
default:
|
|
||||||
num = str[pos:i]
|
|
||||||
pos = i
|
|
||||||
break Num
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// if we stripped all numerator positions, always return 0
|
|
||||||
if len(num) == 0 {
|
|
||||||
num = "0"
|
|
||||||
}
|
|
||||||
|
|
||||||
// handle a denominator
|
|
||||||
if pos < end && str[pos] == '.' {
|
|
||||||
pos++
|
|
||||||
Denom:
|
|
||||||
for i := pos; ; i++ {
|
|
||||||
if i >= end {
|
|
||||||
denom = str[pos:end]
|
|
||||||
value = str[0:end]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch str[i] {
|
|
||||||
case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9':
|
|
||||||
default:
|
|
||||||
denom = str[pos:i]
|
|
||||||
pos = i
|
|
||||||
break Denom
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// TODO: we currently allow 1.G, but we may not want to in the future.
|
|
||||||
// if len(denom) == 0 {
|
|
||||||
// err = ErrFormatWrong
|
|
||||||
// return
|
|
||||||
// }
|
|
||||||
}
|
|
||||||
value = str[0:pos]
|
|
||||||
|
|
||||||
// grab the elements of the suffix
|
|
||||||
suffixStart := pos
|
|
||||||
for i := pos; ; i++ {
|
|
||||||
if i >= end {
|
|
||||||
suffix = str[suffixStart:end]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if !strings.ContainsAny(str[i:i+1], "eEinumkKMGTP") {
|
|
||||||
pos = i
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if pos < end {
|
|
||||||
switch str[pos] {
|
|
||||||
case '-', '+':
|
|
||||||
pos++
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Suffix:
|
|
||||||
for i := pos; ; i++ {
|
|
||||||
if i >= end {
|
|
||||||
suffix = str[suffixStart:end]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch str[i] {
|
|
||||||
case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9':
|
|
||||||
default:
|
|
||||||
break Suffix
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// we encountered a non decimal in the Suffix loop, but the last character
|
|
||||||
// was not a valid exponent
|
|
||||||
err = ErrFormatWrong
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseQuantity turns str into a Quantity, or returns an error.
|
|
||||||
func ParseQuantity(str string) (Quantity, error) {
|
|
||||||
if len(str) == 0 {
|
|
||||||
return Quantity{}, ErrFormatWrong
|
|
||||||
}
|
|
||||||
if str == "0" {
|
|
||||||
return Quantity{Format: DecimalSI, s: str}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
positive, value, num, denom, suf, err := parseQuantityString(str)
|
|
||||||
if err != nil {
|
|
||||||
return Quantity{}, err
|
|
||||||
}
|
|
||||||
|
|
||||||
base, exponent, format, ok := quantitySuffixer.interpret(suffix(suf))
|
|
||||||
if !ok {
|
|
||||||
return Quantity{}, ErrSuffix
|
|
||||||
}
|
|
||||||
|
|
||||||
precision := int32(0)
|
|
||||||
scale := int32(0)
|
|
||||||
mantissa := int64(1)
|
|
||||||
switch format {
|
|
||||||
case DecimalExponent, DecimalSI:
|
|
||||||
scale = exponent
|
|
||||||
precision = maxInt64Factors - int32(len(num)+len(denom))
|
|
||||||
case BinarySI:
|
|
||||||
scale = 0
|
|
||||||
switch {
|
|
||||||
case exponent >= 0 && len(denom) == 0:
|
|
||||||
// only handle positive binary numbers with the fast path
|
|
||||||
mantissa = int64(int64(mantissa) << uint64(exponent))
|
|
||||||
// 1Mi (2^20) has ~6 digits of decimal precision, so exponent*3/10 -1 is roughly the precision
|
|
||||||
precision = 15 - int32(len(num)) - int32(float32(exponent)*3/10) - 1
|
|
||||||
default:
|
|
||||||
precision = -1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if precision >= 0 {
|
|
||||||
// if we have a denominator, shift the entire value to the left by the number of places in the
|
|
||||||
// denominator
|
|
||||||
scale -= int32(len(denom))
|
|
||||||
if scale >= int32(Nano) {
|
|
||||||
shifted := num + denom
|
|
||||||
|
|
||||||
var value int64
|
|
||||||
value, err := strconv.ParseInt(shifted, 10, 64)
|
|
||||||
if err != nil {
|
|
||||||
return Quantity{}, ErrNumeric
|
|
||||||
}
|
|
||||||
if result, ok := int64Multiply(value, int64(mantissa)); ok {
|
|
||||||
if !positive {
|
|
||||||
result = -result
|
|
||||||
}
|
|
||||||
// if the number is in canonical form, reuse the string
|
|
||||||
switch format {
|
|
||||||
case BinarySI:
|
|
||||||
if exponent%10 == 0 && (value&0x07 != 0) {
|
|
||||||
return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format, s: str}, nil
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
if scale%3 == 0 && !strings.HasSuffix(shifted, "000") && shifted[0] != '0' {
|
|
||||||
return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format, s: str}, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format}, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
amount := new(inf.Dec)
|
|
||||||
if _, ok := amount.SetString(value); !ok {
|
|
||||||
return Quantity{}, ErrNumeric
|
|
||||||
}
|
|
||||||
|
|
||||||
// So that no one but us has to think about suffixes, remove it.
|
|
||||||
if base == 10 {
|
|
||||||
amount.SetScale(amount.Scale() + Scale(exponent).infScale())
|
|
||||||
} else if base == 2 {
|
|
||||||
// numericSuffix = 2 ** exponent
|
|
||||||
numericSuffix := big.NewInt(1).Lsh(bigOne, uint(exponent))
|
|
||||||
ub := amount.UnscaledBig()
|
|
||||||
amount.SetUnscaledBig(ub.Mul(ub, numericSuffix))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Cap at min/max bounds.
|
|
||||||
sign := amount.Sign()
|
|
||||||
if sign == -1 {
|
|
||||||
amount.Neg(amount)
|
|
||||||
}
|
|
||||||
|
|
||||||
// This rounds non-zero values up to the minimum representable value, under the theory that
|
|
||||||
// if you want some resources, you should get some resources, even if you asked for way too small
|
|
||||||
// of an amount. Arguably, this should be inf.RoundHalfUp (normal rounding), but that would have
|
|
||||||
// the side effect of rounding values < .5n to zero.
|
|
||||||
if v, ok := amount.Unscaled(); v != int64(0) || !ok {
|
|
||||||
amount.Round(amount, Nano.infScale(), inf.RoundUp)
|
|
||||||
}
|
|
||||||
|
|
||||||
// The max is just a simple cap.
|
|
||||||
// TODO: this prevents accumulating quantities greater than int64, for instance quota across a cluster
|
|
||||||
if format == BinarySI && amount.Cmp(maxAllowed.Dec) > 0 {
|
|
||||||
amount.Set(maxAllowed.Dec)
|
|
||||||
}
|
|
||||||
|
|
||||||
if format == BinarySI && amount.Cmp(decOne) < 0 && amount.Cmp(decZero) > 0 {
|
|
||||||
// This avoids rounding and hopefully confusion, too.
|
|
||||||
format = DecimalSI
|
|
||||||
}
|
|
||||||
if sign == -1 {
|
|
||||||
amount.Neg(amount)
|
|
||||||
}
|
|
||||||
|
|
||||||
return Quantity{d: infDecAmount{amount}, Format: format}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// DeepCopy returns a deep-copy of the Quantity value. Note that the method
|
|
||||||
// receiver is a value, so we can mutate it in-place and return it.
|
|
||||||
func (q Quantity) DeepCopy() Quantity {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
tmp := &inf.Dec{}
|
|
||||||
q.d.Dec = tmp.Set(q.d.Dec)
|
|
||||||
}
|
|
||||||
return q
|
|
||||||
}
|
|
||||||
|
|
||||||
// OpenAPIDefinition returns openAPI definition for this type.
|
|
||||||
func (_ Quantity) OpenAPIDefinition() openapi.OpenAPIDefinition {
|
|
||||||
return openapi.OpenAPIDefinition{
|
|
||||||
Schema: spec.Schema{
|
|
||||||
SchemaProps: spec.SchemaProps{
|
|
||||||
Type: []string{"string"},
|
|
||||||
Format: "",
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// CanonicalizeBytes returns the canonical form of q and its suffix (see comment on Quantity).
|
|
||||||
//
|
|
||||||
// Note about BinarySI:
|
|
||||||
// * If q.Format is set to BinarySI and q.Amount represents a non-zero value between
|
|
||||||
// -1 and +1, it will be emitted as if q.Format were DecimalSI.
|
|
||||||
// * Otherwise, if q.Format is set to BinarySI, frational parts of q.Amount will be
|
|
||||||
// rounded up. (1.1i becomes 2i.)
|
|
||||||
func (q *Quantity) CanonicalizeBytes(out []byte) (result, suffix []byte) {
|
|
||||||
if q.IsZero() {
|
|
||||||
return zeroBytes, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
var rounded CanonicalValue
|
|
||||||
format := q.Format
|
|
||||||
switch format {
|
|
||||||
case DecimalExponent, DecimalSI:
|
|
||||||
case BinarySI:
|
|
||||||
if q.CmpInt64(-1024) > 0 && q.CmpInt64(1024) < 0 {
|
|
||||||
// This avoids rounding and hopefully confusion, too.
|
|
||||||
format = DecimalSI
|
|
||||||
} else {
|
|
||||||
var exact bool
|
|
||||||
if rounded, exact = q.AsScale(0); !exact {
|
|
||||||
// Don't lose precision-- show as DecimalSI
|
|
||||||
format = DecimalSI
|
|
||||||
}
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
format = DecimalExponent
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: If BinarySI formatting is requested but would cause rounding, upgrade to
|
|
||||||
// one of the other formats.
|
|
||||||
switch format {
|
|
||||||
case DecimalExponent, DecimalSI:
|
|
||||||
number, exponent := q.AsCanonicalBytes(out)
|
|
||||||
suffix, _ := quantitySuffixer.constructBytes(10, exponent, format)
|
|
||||||
return number, suffix
|
|
||||||
default:
|
|
||||||
// format must be BinarySI
|
|
||||||
number, exponent := rounded.AsCanonicalBase1024Bytes(out)
|
|
||||||
suffix, _ := quantitySuffixer.constructBytes(2, exponent*10, format)
|
|
||||||
return number, suffix
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsInt64 returns a representation of the current value as an int64 if a fast conversion
|
|
||||||
// is possible. If false is returned, callers must use the inf.Dec form of this quantity.
|
|
||||||
func (q *Quantity) AsInt64() (int64, bool) {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return 0, false
|
|
||||||
}
|
|
||||||
return q.i.AsInt64()
|
|
||||||
}
|
|
||||||
|
|
||||||
// ToDec promotes the quantity in place to use an inf.Dec representation and returns itself.
|
|
||||||
func (q *Quantity) ToDec() *Quantity {
|
|
||||||
if q.d.Dec == nil {
|
|
||||||
q.d.Dec = q.i.AsDec()
|
|
||||||
q.i = int64Amount{}
|
|
||||||
}
|
|
||||||
return q
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsDec returns the quantity as represented by a scaled inf.Dec.
|
|
||||||
func (q *Quantity) AsDec() *inf.Dec {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.Dec
|
|
||||||
}
|
|
||||||
q.d.Dec = q.i.AsDec()
|
|
||||||
q.i = int64Amount{}
|
|
||||||
return q.d.Dec
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsCanonicalBytes returns the canonical byte representation of this quantity as a mantissa
|
|
||||||
// and base 10 exponent. The out byte slice may be passed to the method to avoid an extra
|
|
||||||
// allocation.
|
|
||||||
func (q *Quantity) AsCanonicalBytes(out []byte) (result []byte, exponent int32) {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.AsCanonicalBytes(out)
|
|
||||||
}
|
|
||||||
return q.i.AsCanonicalBytes(out)
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsZero returns true if the quantity is equal to zero.
|
|
||||||
func (q *Quantity) IsZero() bool {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.Dec.Sign() == 0
|
|
||||||
}
|
|
||||||
return q.i.value == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sign returns 0 if the quantity is zero, -1 if the quantity is less than zero, or 1 if the
|
|
||||||
// quantity is greater than zero.
|
|
||||||
func (q *Quantity) Sign() int {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.Dec.Sign()
|
|
||||||
}
|
|
||||||
return q.i.Sign()
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsScaled returns the current value, rounded up to the provided scale, and returns
|
|
||||||
// false if the scale resulted in a loss of precision.
|
|
||||||
func (q *Quantity) AsScale(scale Scale) (CanonicalValue, bool) {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.AsScale(scale)
|
|
||||||
}
|
|
||||||
return q.i.AsScale(scale)
|
|
||||||
}
|
|
||||||
|
|
||||||
// RoundUp updates the quantity to the provided scale, ensuring that the value is at
|
|
||||||
// least 1. False is returned if the rounding operation resulted in a loss of precision.
|
|
||||||
// Negative numbers are rounded away from zero (-9 scale 1 rounds to -10).
|
|
||||||
func (q *Quantity) RoundUp(scale Scale) bool {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
q.s = ""
|
|
||||||
d, exact := q.d.AsScale(scale)
|
|
||||||
q.d = d
|
|
||||||
return exact
|
|
||||||
}
|
|
||||||
// avoid clearing the string value if we have already calculated it
|
|
||||||
if q.i.scale >= scale {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
q.s = ""
|
|
||||||
i, exact := q.i.AsScale(scale)
|
|
||||||
q.i = i
|
|
||||||
return exact
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add adds the provide y quantity to the current value. If the current value is zero,
|
|
||||||
// the format of the quantity will be updated to the format of y.
|
|
||||||
func (q *Quantity) Add(y Quantity) {
|
|
||||||
q.s = ""
|
|
||||||
if q.d.Dec == nil && y.d.Dec == nil {
|
|
||||||
if q.i.value == 0 {
|
|
||||||
q.Format = y.Format
|
|
||||||
}
|
|
||||||
if q.i.Add(y.i) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
} else if q.IsZero() {
|
|
||||||
q.Format = y.Format
|
|
||||||
}
|
|
||||||
q.ToDec().d.Dec.Add(q.d.Dec, y.AsDec())
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sub subtracts the provided quantity from the current value in place. If the current
|
|
||||||
// value is zero, the format of the quantity will be updated to the format of y.
|
|
||||||
func (q *Quantity) Sub(y Quantity) {
|
|
||||||
q.s = ""
|
|
||||||
if q.IsZero() {
|
|
||||||
q.Format = y.Format
|
|
||||||
}
|
|
||||||
if q.d.Dec == nil && y.d.Dec == nil && q.i.Sub(y.i) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
q.ToDec().d.Dec.Sub(q.d.Dec, y.AsDec())
|
|
||||||
}
|
|
||||||
|
|
||||||
// Cmp returns 0 if the quantity is equal to y, -1 if the quantity is less than y, or 1 if the
|
|
||||||
// quantity is greater than y.
|
|
||||||
func (q *Quantity) Cmp(y Quantity) int {
|
|
||||||
if q.d.Dec == nil && y.d.Dec == nil {
|
|
||||||
return q.i.Cmp(y.i)
|
|
||||||
}
|
|
||||||
return q.AsDec().Cmp(y.AsDec())
|
|
||||||
}
|
|
||||||
|
|
||||||
// CmpInt64 returns 0 if the quantity is equal to y, -1 if the quantity is less than y, or 1 if the
|
|
||||||
// quantity is greater than y.
|
|
||||||
func (q *Quantity) CmpInt64(y int64) int {
|
|
||||||
if q.d.Dec != nil {
|
|
||||||
return q.d.Dec.Cmp(inf.NewDec(y, inf.Scale(0)))
|
|
||||||
}
|
|
||||||
return q.i.Cmp(int64Amount{value: y})
|
|
||||||
}
|
|
||||||
|
|
||||||
// Neg sets quantity to be the negative value of itself.
|
|
||||||
func (q *Quantity) Neg() {
|
|
||||||
q.s = ""
|
|
||||||
if q.d.Dec == nil {
|
|
||||||
q.i.value = -q.i.value
|
|
||||||
return
|
|
||||||
}
|
|
||||||
q.d.Dec.Neg(q.d.Dec)
|
|
||||||
}
|
|
||||||
|
|
||||||
// int64QuantityExpectedBytes is the expected width in bytes of the canonical string representation
|
|
||||||
// of most Quantity values.
|
|
||||||
const int64QuantityExpectedBytes = 18
|
|
||||||
|
|
||||||
// String formats the Quantity as a string, caching the result if not calculated.
|
|
||||||
// String is an expensive operation and caching this result significantly reduces the cost of
|
|
||||||
// normal parse / marshal operations on Quantity.
|
|
||||||
func (q *Quantity) String() string {
|
|
||||||
if len(q.s) == 0 {
|
|
||||||
result := make([]byte, 0, int64QuantityExpectedBytes)
|
|
||||||
number, suffix := q.CanonicalizeBytes(result)
|
|
||||||
number = append(number, suffix...)
|
|
||||||
q.s = string(number)
|
|
||||||
}
|
|
||||||
return q.s
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON implements the json.Marshaller interface.
|
|
||||||
func (q Quantity) MarshalJSON() ([]byte, error) {
|
|
||||||
if len(q.s) > 0 {
|
|
||||||
out := make([]byte, len(q.s)+2)
|
|
||||||
out[0], out[len(out)-1] = '"', '"'
|
|
||||||
copy(out[1:], q.s)
|
|
||||||
return out, nil
|
|
||||||
}
|
|
||||||
result := make([]byte, int64QuantityExpectedBytes, int64QuantityExpectedBytes)
|
|
||||||
result[0] = '"'
|
|
||||||
number, suffix := q.CanonicalizeBytes(result[1:1])
|
|
||||||
// if the same slice was returned to us that we passed in, avoid another allocation by copying number into
|
|
||||||
// the source slice and returning that
|
|
||||||
if len(number) > 0 && &number[0] == &result[1] && (len(number)+len(suffix)+2) <= int64QuantityExpectedBytes {
|
|
||||||
number = append(number, suffix...)
|
|
||||||
number = append(number, '"')
|
|
||||||
return result[:1+len(number)], nil
|
|
||||||
}
|
|
||||||
// if CanonicalizeBytes needed more space than our slice provided, we may need to allocate again so use
|
|
||||||
// append
|
|
||||||
result = result[:1]
|
|
||||||
result = append(result, number...)
|
|
||||||
result = append(result, suffix...)
|
|
||||||
result = append(result, '"')
|
|
||||||
return result, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON implements the json.Unmarshaller interface.
|
|
||||||
// TODO: Remove support for leading/trailing whitespace
|
|
||||||
func (q *Quantity) UnmarshalJSON(value []byte) error {
|
|
||||||
l := len(value)
|
|
||||||
if l == 4 && bytes.Equal(value, []byte("null")) {
|
|
||||||
q.d.Dec = nil
|
|
||||||
q.i = int64Amount{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if l >= 2 && value[0] == '"' && value[l-1] == '"' {
|
|
||||||
value = value[1 : l-1]
|
|
||||||
}
|
|
||||||
|
|
||||||
parsed, err := ParseQuantity(strings.TrimSpace(string(value)))
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// This copy is safe because parsed will not be referred to again.
|
|
||||||
*q = parsed
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewQuantity returns a new Quantity representing the given
|
|
||||||
// value in the given format.
|
|
||||||
func NewQuantity(value int64, format Format) *Quantity {
|
|
||||||
return &Quantity{
|
|
||||||
i: int64Amount{value: value},
|
|
||||||
Format: format,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewMilliQuantity returns a new Quantity representing the given
|
|
||||||
// value * 1/1000 in the given format. Note that BinarySI formatting
|
|
||||||
// will round fractional values, and will be changed to DecimalSI for
|
|
||||||
// values x where (-1 < x < 1) && (x != 0).
|
|
||||||
func NewMilliQuantity(value int64, format Format) *Quantity {
|
|
||||||
return &Quantity{
|
|
||||||
i: int64Amount{value: value, scale: -3},
|
|
||||||
Format: format,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewScaledQuantity returns a new Quantity representing the given
|
|
||||||
// value * 10^scale in DecimalSI format.
|
|
||||||
func NewScaledQuantity(value int64, scale Scale) *Quantity {
|
|
||||||
return &Quantity{
|
|
||||||
i: int64Amount{value: value, scale: scale},
|
|
||||||
Format: DecimalSI,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Value returns the value of q; any fractional part will be lost.
|
|
||||||
func (q *Quantity) Value() int64 {
|
|
||||||
return q.ScaledValue(0)
|
|
||||||
}
|
|
||||||
|
|
||||||
// MilliValue returns the value of ceil(q * 1000); this could overflow an int64;
|
|
||||||
// if that's a concern, call Value() first to verify the number is small enough.
|
|
||||||
func (q *Quantity) MilliValue() int64 {
|
|
||||||
return q.ScaledValue(Milli)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ScaledValue returns the value of ceil(q * 10^scale); this could overflow an int64.
|
|
||||||
// To detect overflow, call Value() first and verify the expected magnitude.
|
|
||||||
func (q *Quantity) ScaledValue(scale Scale) int64 {
|
|
||||||
if q.d.Dec == nil {
|
|
||||||
i, _ := q.i.AsScaledInt64(scale)
|
|
||||||
return i
|
|
||||||
}
|
|
||||||
dec := q.d.Dec
|
|
||||||
return scaledValue(dec.UnscaledBig(), int(dec.Scale()), int(scale.infScale()))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Set sets q's value to be value.
|
|
||||||
func (q *Quantity) Set(value int64) {
|
|
||||||
q.SetScaled(value, 0)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetMilli sets q's value to be value * 1/1000.
|
|
||||||
func (q *Quantity) SetMilli(value int64) {
|
|
||||||
q.SetScaled(value, Milli)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetScaled sets q's value to be value * 10^scale
|
|
||||||
func (q *Quantity) SetScaled(value int64, scale Scale) {
|
|
||||||
q.s = ""
|
|
||||||
q.d.Dec = nil
|
|
||||||
q.i = int64Amount{value: value, scale: scale}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Copy is a convenience function that makes a deep copy for you. Non-deep
|
|
||||||
// copies of quantities share pointers and you will regret that.
|
|
||||||
func (q *Quantity) Copy() *Quantity {
|
|
||||||
if q.d.Dec == nil {
|
|
||||||
return &Quantity{
|
|
||||||
s: q.s,
|
|
||||||
i: q.i,
|
|
||||||
Format: q.Format,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
tmp := &inf.Dec{}
|
|
||||||
return &Quantity{
|
|
||||||
s: q.s,
|
|
||||||
d: infDecAmount{tmp.Set(q.d.Dec)},
|
|
||||||
Format: q.Format,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// qFlag is a helper type for the Flag function
|
|
||||||
type qFlag struct {
|
|
||||||
dest *Quantity
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sets the value of the internal Quantity. (used by flag & pflag)
|
|
||||||
func (qf qFlag) Set(val string) error {
|
|
||||||
q, err := ParseQuantity(val)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
// This copy is OK because q will not be referenced again.
|
|
||||||
*qf.dest = q
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Converts the value of the internal Quantity to a string. (used by flag & pflag)
|
|
||||||
func (qf qFlag) String() string {
|
|
||||||
return qf.dest.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
// States the type of flag this is (Quantity). (used by pflag)
|
|
||||||
func (qf qFlag) Type() string {
|
|
||||||
return "quantity"
|
|
||||||
}
|
|
||||||
|
|
||||||
// QuantityFlag is a helper that makes a quantity flag (using standard flag package).
|
|
||||||
// Will panic if defaultValue is not a valid quantity.
|
|
||||||
func QuantityFlag(flagName, defaultValue, description string) *Quantity {
|
|
||||||
q := MustParse(defaultValue)
|
|
||||||
flag.Var(NewQuantityFlagValue(&q), flagName, description)
|
|
||||||
return &q
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewQuantityFlagValue returns an object that can be used to back a flag,
|
|
||||||
// pointing at the given Quantity variable.
|
|
||||||
func NewQuantityFlagValue(q *Quantity) flag.Value {
|
|
||||||
return qFlag{q}
|
|
||||||
}
|
|
||||||
@@ -1,284 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
|
|
||||||
"github.com/gogo/protobuf/proto"
|
|
||||||
)
|
|
||||||
|
|
||||||
var _ proto.Sizer = &Quantity{}
|
|
||||||
|
|
||||||
func (m *Quantity) Marshal() (data []byte, err error) {
|
|
||||||
size := m.Size()
|
|
||||||
data = make([]byte, size)
|
|
||||||
n, err := m.MarshalTo(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return data[:n], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalTo is a customized version of the generated Protobuf unmarshaler for a struct
|
|
||||||
// with a single string field.
|
|
||||||
func (m *Quantity) MarshalTo(data []byte) (int, error) {
|
|
||||||
var i int
|
|
||||||
_ = i
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
|
|
||||||
data[i] = 0xa
|
|
||||||
i++
|
|
||||||
// BEGIN CUSTOM MARSHAL
|
|
||||||
out := m.String()
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(out)))
|
|
||||||
i += copy(data[i:], out)
|
|
||||||
// END CUSTOM MARSHAL
|
|
||||||
|
|
||||||
return i, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func encodeVarintGenerated(data []byte, offset int, v uint64) int {
|
|
||||||
for v >= 1<<7 {
|
|
||||||
data[offset] = uint8(v&0x7f | 0x80)
|
|
||||||
v >>= 7
|
|
||||||
offset++
|
|
||||||
}
|
|
||||||
data[offset] = uint8(v)
|
|
||||||
return offset + 1
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *Quantity) Size() (n int) {
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
|
|
||||||
// BEGIN CUSTOM SIZE
|
|
||||||
l = len(m.String())
|
|
||||||
// END CUSTOM SIZE
|
|
||||||
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
func sovGenerated(x uint64) (n int) {
|
|
||||||
for {
|
|
||||||
n++
|
|
||||||
x >>= 7
|
|
||||||
if x == 0 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unmarshal is a customized version of the generated Protobuf unmarshaler for a struct
|
|
||||||
// with a single string field.
|
|
||||||
func (m *Quantity) Unmarshal(data []byte) error {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
preIndex := iNdEx
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
fieldNum := int32(wire >> 3)
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
if wireType == 4 {
|
|
||||||
return fmt.Errorf("proto: Quantity: wiretype end group for non-group")
|
|
||||||
}
|
|
||||||
if fieldNum <= 0 {
|
|
||||||
return fmt.Errorf("proto: Quantity: illegal tag %d (wire type %d)", fieldNum, wire)
|
|
||||||
}
|
|
||||||
switch fieldNum {
|
|
||||||
case 1:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field String_", wireType)
|
|
||||||
}
|
|
||||||
var stringLen uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
stringLen |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
intStringLen := int(stringLen)
|
|
||||||
if intStringLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + intStringLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
s := string(data[iNdEx:postIndex])
|
|
||||||
|
|
||||||
// BEGIN CUSTOM DECODE
|
|
||||||
p, err := ParseQuantity(s)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
*m = p
|
|
||||||
// END CUSTOM DECODE
|
|
||||||
|
|
||||||
iNdEx = postIndex
|
|
||||||
default:
|
|
||||||
iNdEx = preIndex
|
|
||||||
skippy, err := skipGenerated(data[iNdEx:])
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if skippy < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
if (iNdEx + skippy) > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx += skippy
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if iNdEx > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func skipGenerated(data []byte) (n int, err error) {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
switch wireType {
|
|
||||||
case 0:
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx++
|
|
||||||
if data[iNdEx-1] < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 1:
|
|
||||||
iNdEx += 8
|
|
||||||
return iNdEx, nil
|
|
||||||
case 2:
|
|
||||||
var length int
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
length |= (int(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
iNdEx += length
|
|
||||||
if length < 0 {
|
|
||||||
return 0, ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 3:
|
|
||||||
for {
|
|
||||||
var innerWire uint64
|
|
||||||
var start int = iNdEx
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
innerWire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
innerWireType := int(innerWire & 0x7)
|
|
||||||
if innerWireType == 4 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
next, err := skipGenerated(data[start:])
|
|
||||||
if err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
iNdEx = start + next
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 4:
|
|
||||||
return iNdEx, nil
|
|
||||||
case 5:
|
|
||||||
iNdEx += 4
|
|
||||||
return iNdEx, nil
|
|
||||||
default:
|
|
||||||
return 0, fmt.Errorf("proto: illegal wireType %d", wireType)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
panic("unreachable")
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
ErrInvalidLengthGenerated = fmt.Errorf("proto: negative length found during unmarshaling")
|
|
||||||
ErrIntOverflowGenerated = fmt.Errorf("proto: integer overflow")
|
|
||||||
)
|
|
||||||
@@ -1,95 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"math"
|
|
||||||
"math/big"
|
|
||||||
"sync"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
// A sync pool to reduce allocation.
|
|
||||||
intPool sync.Pool
|
|
||||||
maxInt64 = big.NewInt(math.MaxInt64)
|
|
||||||
)
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
intPool.New = func() interface{} {
|
|
||||||
return &big.Int{}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// scaledValue scales given unscaled value from scale to new Scale and returns
|
|
||||||
// an int64. It ALWAYS rounds up the result when scale down. The final result might
|
|
||||||
// overflow.
|
|
||||||
//
|
|
||||||
// scale, newScale represents the scale of the unscaled decimal.
|
|
||||||
// The mathematical value of the decimal is unscaled * 10**(-scale).
|
|
||||||
func scaledValue(unscaled *big.Int, scale, newScale int) int64 {
|
|
||||||
dif := scale - newScale
|
|
||||||
if dif == 0 {
|
|
||||||
return unscaled.Int64()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle scale up
|
|
||||||
// This is an easy case, we do not need to care about rounding and overflow.
|
|
||||||
// If any intermediate operation causes overflow, the result will overflow.
|
|
||||||
if dif < 0 {
|
|
||||||
return unscaled.Int64() * int64(math.Pow10(-dif))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle scale down
|
|
||||||
// We have to be careful about the intermediate operations.
|
|
||||||
|
|
||||||
// fast path when unscaled < max.Int64 and exp(10,dif) < max.Int64
|
|
||||||
const log10MaxInt64 = 19
|
|
||||||
if unscaled.Cmp(maxInt64) < 0 && dif < log10MaxInt64 {
|
|
||||||
divide := int64(math.Pow10(dif))
|
|
||||||
result := unscaled.Int64() / divide
|
|
||||||
mod := unscaled.Int64() % divide
|
|
||||||
if mod != 0 {
|
|
||||||
return result + 1
|
|
||||||
}
|
|
||||||
return result
|
|
||||||
}
|
|
||||||
|
|
||||||
// We should only convert back to int64 when getting the result.
|
|
||||||
divisor := intPool.Get().(*big.Int)
|
|
||||||
exp := intPool.Get().(*big.Int)
|
|
||||||
result := intPool.Get().(*big.Int)
|
|
||||||
defer func() {
|
|
||||||
intPool.Put(divisor)
|
|
||||||
intPool.Put(exp)
|
|
||||||
intPool.Put(result)
|
|
||||||
}()
|
|
||||||
|
|
||||||
// divisor = 10^(dif)
|
|
||||||
// TODO: create loop up table if exp costs too much.
|
|
||||||
divisor.Exp(bigTen, exp.SetInt64(int64(dif)), nil)
|
|
||||||
// reuse exp
|
|
||||||
remainder := exp
|
|
||||||
|
|
||||||
// result = unscaled / divisor
|
|
||||||
// remainder = unscaled % divisor
|
|
||||||
result.DivMod(unscaled, divisor, remainder)
|
|
||||||
if remainder.Sign() != 0 {
|
|
||||||
return result.Int64() + 1
|
|
||||||
}
|
|
||||||
|
|
||||||
return result.Int64()
|
|
||||||
}
|
|
||||||
@@ -1,198 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 resource
|
|
||||||
|
|
||||||
import (
|
|
||||||
"strconv"
|
|
||||||
)
|
|
||||||
|
|
||||||
type suffix string
|
|
||||||
|
|
||||||
// suffixer can interpret and construct suffixes.
|
|
||||||
type suffixer interface {
|
|
||||||
interpret(suffix) (base, exponent int32, fmt Format, ok bool)
|
|
||||||
construct(base, exponent int32, fmt Format) (s suffix, ok bool)
|
|
||||||
constructBytes(base, exponent int32, fmt Format) (s []byte, ok bool)
|
|
||||||
}
|
|
||||||
|
|
||||||
// quantitySuffixer handles suffixes for all three formats that quantity
|
|
||||||
// can handle.
|
|
||||||
var quantitySuffixer = newSuffixer()
|
|
||||||
|
|
||||||
type bePair struct {
|
|
||||||
base, exponent int32
|
|
||||||
}
|
|
||||||
|
|
||||||
type listSuffixer struct {
|
|
||||||
suffixToBE map[suffix]bePair
|
|
||||||
beToSuffix map[bePair]suffix
|
|
||||||
beToSuffixBytes map[bePair][]byte
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ls *listSuffixer) addSuffix(s suffix, pair bePair) {
|
|
||||||
if ls.suffixToBE == nil {
|
|
||||||
ls.suffixToBE = map[suffix]bePair{}
|
|
||||||
}
|
|
||||||
if ls.beToSuffix == nil {
|
|
||||||
ls.beToSuffix = map[bePair]suffix{}
|
|
||||||
}
|
|
||||||
if ls.beToSuffixBytes == nil {
|
|
||||||
ls.beToSuffixBytes = map[bePair][]byte{}
|
|
||||||
}
|
|
||||||
ls.suffixToBE[s] = pair
|
|
||||||
ls.beToSuffix[pair] = s
|
|
||||||
ls.beToSuffixBytes[pair] = []byte(s)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ls *listSuffixer) lookup(s suffix) (base, exponent int32, ok bool) {
|
|
||||||
pair, ok := ls.suffixToBE[s]
|
|
||||||
if !ok {
|
|
||||||
return 0, 0, false
|
|
||||||
}
|
|
||||||
return pair.base, pair.exponent, true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ls *listSuffixer) construct(base, exponent int32) (s suffix, ok bool) {
|
|
||||||
s, ok = ls.beToSuffix[bePair{base, exponent}]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ls *listSuffixer) constructBytes(base, exponent int32) (s []byte, ok bool) {
|
|
||||||
s, ok = ls.beToSuffixBytes[bePair{base, exponent}]
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
type suffixHandler struct {
|
|
||||||
decSuffixes listSuffixer
|
|
||||||
binSuffixes listSuffixer
|
|
||||||
}
|
|
||||||
|
|
||||||
type fastLookup struct {
|
|
||||||
*suffixHandler
|
|
||||||
}
|
|
||||||
|
|
||||||
func (l fastLookup) interpret(s suffix) (base, exponent int32, format Format, ok bool) {
|
|
||||||
switch s {
|
|
||||||
case "":
|
|
||||||
return 10, 0, DecimalSI, true
|
|
||||||
case "n":
|
|
||||||
return 10, -9, DecimalSI, true
|
|
||||||
case "u":
|
|
||||||
return 10, -6, DecimalSI, true
|
|
||||||
case "m":
|
|
||||||
return 10, -3, DecimalSI, true
|
|
||||||
case "k":
|
|
||||||
return 10, 3, DecimalSI, true
|
|
||||||
case "M":
|
|
||||||
return 10, 6, DecimalSI, true
|
|
||||||
case "G":
|
|
||||||
return 10, 9, DecimalSI, true
|
|
||||||
}
|
|
||||||
return l.suffixHandler.interpret(s)
|
|
||||||
}
|
|
||||||
|
|
||||||
func newSuffixer() suffixer {
|
|
||||||
sh := &suffixHandler{}
|
|
||||||
|
|
||||||
// IMPORTANT: if you change this section you must change fastLookup
|
|
||||||
|
|
||||||
sh.binSuffixes.addSuffix("Ki", bePair{2, 10})
|
|
||||||
sh.binSuffixes.addSuffix("Mi", bePair{2, 20})
|
|
||||||
sh.binSuffixes.addSuffix("Gi", bePair{2, 30})
|
|
||||||
sh.binSuffixes.addSuffix("Ti", bePair{2, 40})
|
|
||||||
sh.binSuffixes.addSuffix("Pi", bePair{2, 50})
|
|
||||||
sh.binSuffixes.addSuffix("Ei", bePair{2, 60})
|
|
||||||
// Don't emit an error when trying to produce
|
|
||||||
// a suffix for 2^0.
|
|
||||||
sh.decSuffixes.addSuffix("", bePair{2, 0})
|
|
||||||
|
|
||||||
sh.decSuffixes.addSuffix("n", bePair{10, -9})
|
|
||||||
sh.decSuffixes.addSuffix("u", bePair{10, -6})
|
|
||||||
sh.decSuffixes.addSuffix("m", bePair{10, -3})
|
|
||||||
sh.decSuffixes.addSuffix("", bePair{10, 0})
|
|
||||||
sh.decSuffixes.addSuffix("k", bePair{10, 3})
|
|
||||||
sh.decSuffixes.addSuffix("M", bePair{10, 6})
|
|
||||||
sh.decSuffixes.addSuffix("G", bePair{10, 9})
|
|
||||||
sh.decSuffixes.addSuffix("T", bePair{10, 12})
|
|
||||||
sh.decSuffixes.addSuffix("P", bePair{10, 15})
|
|
||||||
sh.decSuffixes.addSuffix("E", bePair{10, 18})
|
|
||||||
|
|
||||||
return fastLookup{sh}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (sh *suffixHandler) construct(base, exponent int32, fmt Format) (s suffix, ok bool) {
|
|
||||||
switch fmt {
|
|
||||||
case DecimalSI:
|
|
||||||
return sh.decSuffixes.construct(base, exponent)
|
|
||||||
case BinarySI:
|
|
||||||
return sh.binSuffixes.construct(base, exponent)
|
|
||||||
case DecimalExponent:
|
|
||||||
if base != 10 {
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
if exponent == 0 {
|
|
||||||
return "", true
|
|
||||||
}
|
|
||||||
return suffix("e" + strconv.FormatInt(int64(exponent), 10)), true
|
|
||||||
}
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (sh *suffixHandler) constructBytes(base, exponent int32, format Format) (s []byte, ok bool) {
|
|
||||||
switch format {
|
|
||||||
case DecimalSI:
|
|
||||||
return sh.decSuffixes.constructBytes(base, exponent)
|
|
||||||
case BinarySI:
|
|
||||||
return sh.binSuffixes.constructBytes(base, exponent)
|
|
||||||
case DecimalExponent:
|
|
||||||
if base != 10 {
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
if exponent == 0 {
|
|
||||||
return nil, true
|
|
||||||
}
|
|
||||||
result := make([]byte, 8, 8)
|
|
||||||
result[0] = 'e'
|
|
||||||
number := strconv.AppendInt(result[1:1], int64(exponent), 10)
|
|
||||||
if &result[1] == &number[0] {
|
|
||||||
return result[:1+len(number)], true
|
|
||||||
}
|
|
||||||
result = append(result[:1], number...)
|
|
||||||
return result, true
|
|
||||||
}
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (sh *suffixHandler) interpret(suffix suffix) (base, exponent int32, fmt Format, ok bool) {
|
|
||||||
// Try lookup tables first
|
|
||||||
if b, e, ok := sh.decSuffixes.lookup(suffix); ok {
|
|
||||||
return b, e, DecimalSI, true
|
|
||||||
}
|
|
||||||
if b, e, ok := sh.binSuffixes.lookup(suffix); ok {
|
|
||||||
return b, e, BinarySI, true
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(suffix) > 1 && (suffix[0] == 'E' || suffix[0] == 'e') {
|
|
||||||
parsed, err := strconv.ParseInt(string(suffix[1:]), 10, 64)
|
|
||||||
if err != nil {
|
|
||||||
return 0, 0, DecimalExponent, false
|
|
||||||
}
|
|
||||||
return 10, int32(parsed), DecimalExponent, true
|
|
||||||
}
|
|
||||||
|
|
||||||
return 0, 0, DecimalExponent, false
|
|
||||||
}
|
|
||||||
@@ -1,99 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 announced contains tools for announcing API group factories. This is
|
|
||||||
// distinct from registration (in the 'registered' package) in that it's safe
|
|
||||||
// to announce every possible group linked in, but only groups requested at
|
|
||||||
// runtime should be registered. This package contains both a registry, and
|
|
||||||
// factory code (which was formerly copy-pasta in every install package).
|
|
||||||
package announced
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/apimachinery/registered"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
)
|
|
||||||
|
|
||||||
// APIGroupFactoryRegistry allows for groups and versions to announce themselves,
|
|
||||||
// which simply makes them available and doesn't take other actions. Later,
|
|
||||||
// users of the registry can select which groups and versions they'd actually
|
|
||||||
// like to register with an APIRegistrationManager.
|
|
||||||
//
|
|
||||||
// (Right now APIRegistrationManager has separate 'registration' and 'enabled'
|
|
||||||
// concepts-- APIGroupFactory is going to take over the former function;
|
|
||||||
// they will overlap untill the refactoring is finished.)
|
|
||||||
//
|
|
||||||
// The key is the group name. After initialization, this should be treated as
|
|
||||||
// read-only. It is implemented as a map from group name to group factory, and
|
|
||||||
// it is safe to use this knowledge to manually pick out groups to register
|
|
||||||
// (e.g., for testing).
|
|
||||||
type APIGroupFactoryRegistry map[string]*GroupMetaFactory
|
|
||||||
|
|
||||||
func (gar APIGroupFactoryRegistry) group(groupName string) *GroupMetaFactory {
|
|
||||||
gmf, ok := gar[groupName]
|
|
||||||
if !ok {
|
|
||||||
gmf = &GroupMetaFactory{VersionArgs: map[string]*GroupVersionFactoryArgs{}}
|
|
||||||
gar[groupName] = gmf
|
|
||||||
}
|
|
||||||
return gmf
|
|
||||||
}
|
|
||||||
|
|
||||||
// AnnounceGroupVersion adds the particular arguments for this group version to the group factory.
|
|
||||||
func (gar APIGroupFactoryRegistry) AnnounceGroupVersion(gvf *GroupVersionFactoryArgs) error {
|
|
||||||
gmf := gar.group(gvf.GroupName)
|
|
||||||
if _, ok := gmf.VersionArgs[gvf.VersionName]; ok {
|
|
||||||
return fmt.Errorf("version %q in group %q has already been announced", gvf.VersionName, gvf.GroupName)
|
|
||||||
}
|
|
||||||
gmf.VersionArgs[gvf.VersionName] = gvf
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AnnounceGroup adds the group-wide arguments to the group factory.
|
|
||||||
func (gar APIGroupFactoryRegistry) AnnounceGroup(args *GroupMetaFactoryArgs) error {
|
|
||||||
gmf := gar.group(args.GroupName)
|
|
||||||
if gmf.GroupArgs != nil {
|
|
||||||
return fmt.Errorf("group %q has already been announced", args.GroupName)
|
|
||||||
}
|
|
||||||
gmf.GroupArgs = args
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterAndEnableAll throws every factory at the specified API registration
|
|
||||||
// manager, and lets it decide which to register. (If you want to do this a la
|
|
||||||
// cart, you may look through gar itself-- it's just a map.)
|
|
||||||
func (gar APIGroupFactoryRegistry) RegisterAndEnableAll(m *registered.APIRegistrationManager, scheme *runtime.Scheme) error {
|
|
||||||
for groupName, gmf := range gar {
|
|
||||||
if err := gmf.Register(m); err != nil {
|
|
||||||
return fmt.Errorf("error registering %v: %v", groupName, err)
|
|
||||||
}
|
|
||||||
if err := gmf.Enable(m, scheme); err != nil {
|
|
||||||
return fmt.Errorf("error enabling %v: %v", groupName, err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AnnouncePreconstructedFactory announces a factory which you've manually assembled.
|
|
||||||
// You may call this instead of calling AnnounceGroup and AnnounceGroupVersion.
|
|
||||||
func (gar APIGroupFactoryRegistry) AnnouncePreconstructedFactory(gmf *GroupMetaFactory) error {
|
|
||||||
name := gmf.GroupArgs.GroupName
|
|
||||||
if _, exists := gar[name]; exists {
|
|
||||||
return fmt.Errorf("the group %q has already been announced.", name)
|
|
||||||
}
|
|
||||||
gar[name] = gmf
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,252 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 announced
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"github.com/golang/glog"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/api/meta"
|
|
||||||
"k8s.io/apimachinery/pkg/apimachinery"
|
|
||||||
"k8s.io/apimachinery/pkg/apimachinery/registered"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/util/sets"
|
|
||||||
)
|
|
||||||
|
|
||||||
type SchemeFunc func(*runtime.Scheme) error
|
|
||||||
type VersionToSchemeFunc map[string]SchemeFunc
|
|
||||||
|
|
||||||
// GroupVersionFactoryArgs contains all the per-version parts of a GroupMetaFactory.
|
|
||||||
type GroupVersionFactoryArgs struct {
|
|
||||||
GroupName string
|
|
||||||
VersionName string
|
|
||||||
|
|
||||||
AddToScheme SchemeFunc
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupMetaFactoryArgs contains the group-level args of a GroupMetaFactory.
|
|
||||||
type GroupMetaFactoryArgs struct {
|
|
||||||
// GroupName is the name of the API-Group
|
|
||||||
//
|
|
||||||
// example: 'servicecatalog.k8s.io'
|
|
||||||
GroupName string
|
|
||||||
VersionPreferenceOrder []string
|
|
||||||
// ImportPrefix is the base go package of the API-Group
|
|
||||||
//
|
|
||||||
// example: 'k8s.io/kubernetes/pkg/apis/autoscaling'
|
|
||||||
ImportPrefix string
|
|
||||||
// RootScopedKinds are resources that are not namespaced.
|
|
||||||
RootScopedKinds sets.String // nil is allowed
|
|
||||||
IgnoredKinds sets.String // nil is allowed
|
|
||||||
|
|
||||||
// May be nil if there are no internal objects.
|
|
||||||
AddInternalObjectsToScheme SchemeFunc
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewGroupMetaFactory builds the args for you. This is for if you're
|
|
||||||
// constructing a factory all at once and not using the registry.
|
|
||||||
func NewGroupMetaFactory(groupArgs *GroupMetaFactoryArgs, versions VersionToSchemeFunc) *GroupMetaFactory {
|
|
||||||
gmf := &GroupMetaFactory{
|
|
||||||
GroupArgs: groupArgs,
|
|
||||||
VersionArgs: map[string]*GroupVersionFactoryArgs{},
|
|
||||||
}
|
|
||||||
for v, f := range versions {
|
|
||||||
gmf.VersionArgs[v] = &GroupVersionFactoryArgs{
|
|
||||||
GroupName: groupArgs.GroupName,
|
|
||||||
VersionName: v,
|
|
||||||
AddToScheme: f,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return gmf
|
|
||||||
}
|
|
||||||
|
|
||||||
// Announce adds this Group factory to the global factory registry. It should
|
|
||||||
// only be called if you constructed the GroupMetaFactory yourself via
|
|
||||||
// NewGroupMetadFactory.
|
|
||||||
// Note that this will panic on an error, since it's expected that you'll be
|
|
||||||
// calling this at initialization time and any error is a result of a
|
|
||||||
// programmer importing the wrong set of packages. If this assumption doesn't
|
|
||||||
// work for you, just call DefaultGroupFactoryRegistry.AnnouncePreconstructedFactory
|
|
||||||
// yourself.
|
|
||||||
func (gmf *GroupMetaFactory) Announce(groupFactoryRegistry APIGroupFactoryRegistry) *GroupMetaFactory {
|
|
||||||
if err := groupFactoryRegistry.AnnouncePreconstructedFactory(gmf); err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return gmf
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupMetaFactory has the logic for actually assembling and registering a group.
|
|
||||||
//
|
|
||||||
// There are two ways of obtaining one of these.
|
|
||||||
// 1. You can announce your group and versions separately, and then let the
|
|
||||||
// GroupFactoryRegistry assemble this object for you. (This allows group and
|
|
||||||
// versions to be imported separately, without referencing each other, to
|
|
||||||
// keep import trees small.)
|
|
||||||
// 2. You can call NewGroupMetaFactory(), which is mostly a drop-in replacement
|
|
||||||
// for the old, bad way of doing things. You can then call .Announce() to
|
|
||||||
// announce your constructed factory to any code that would like to do
|
|
||||||
// things the new, better way.
|
|
||||||
//
|
|
||||||
// Note that GroupMetaFactory actually does construct GroupMeta objects, but
|
|
||||||
// currently it does so in a way that's very entangled with an
|
|
||||||
// APIRegistrationManager. It's a TODO item to cleanly separate that interface.
|
|
||||||
type GroupMetaFactory struct {
|
|
||||||
GroupArgs *GroupMetaFactoryArgs
|
|
||||||
// map of version name to version factory
|
|
||||||
VersionArgs map[string]*GroupVersionFactoryArgs
|
|
||||||
|
|
||||||
// assembled by Register()
|
|
||||||
prioritizedVersionList []schema.GroupVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
// Register constructs the finalized prioritized version list and sanity checks
|
|
||||||
// the announced group & versions. Then it calls register.
|
|
||||||
func (gmf *GroupMetaFactory) Register(m *registered.APIRegistrationManager) error {
|
|
||||||
if gmf.GroupArgs == nil {
|
|
||||||
return fmt.Errorf("partially announced groups are not allowed, only got versions: %#v", gmf.VersionArgs)
|
|
||||||
}
|
|
||||||
if len(gmf.VersionArgs) == 0 {
|
|
||||||
return fmt.Errorf("group %v announced but no versions announced", gmf.GroupArgs.GroupName)
|
|
||||||
}
|
|
||||||
|
|
||||||
pvSet := sets.NewString(gmf.GroupArgs.VersionPreferenceOrder...)
|
|
||||||
if pvSet.Len() != len(gmf.GroupArgs.VersionPreferenceOrder) {
|
|
||||||
return fmt.Errorf("preference order for group %v has duplicates: %v", gmf.GroupArgs.GroupName, gmf.GroupArgs.VersionPreferenceOrder)
|
|
||||||
}
|
|
||||||
prioritizedVersions := []schema.GroupVersion{}
|
|
||||||
for _, v := range gmf.GroupArgs.VersionPreferenceOrder {
|
|
||||||
prioritizedVersions = append(
|
|
||||||
prioritizedVersions,
|
|
||||||
schema.GroupVersion{
|
|
||||||
Group: gmf.GroupArgs.GroupName,
|
|
||||||
Version: v,
|
|
||||||
},
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Go through versions that weren't explicitly prioritized.
|
|
||||||
unprioritizedVersions := []schema.GroupVersion{}
|
|
||||||
for _, v := range gmf.VersionArgs {
|
|
||||||
if v.GroupName != gmf.GroupArgs.GroupName {
|
|
||||||
return fmt.Errorf("found %v/%v in group %v?", v.GroupName, v.VersionName, gmf.GroupArgs.GroupName)
|
|
||||||
}
|
|
||||||
if pvSet.Has(v.VersionName) {
|
|
||||||
pvSet.Delete(v.VersionName)
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
unprioritizedVersions = append(unprioritizedVersions, schema.GroupVersion{Group: v.GroupName, Version: v.VersionName})
|
|
||||||
}
|
|
||||||
if len(unprioritizedVersions) > 1 {
|
|
||||||
glog.Warningf("group %v has multiple unprioritized versions: %#v. They will have an arbitrary preference order!", gmf.GroupArgs.GroupName, unprioritizedVersions)
|
|
||||||
}
|
|
||||||
if pvSet.Len() != 0 {
|
|
||||||
return fmt.Errorf("group %v has versions in the priority list that were never announced: %s", gmf.GroupArgs.GroupName, pvSet)
|
|
||||||
}
|
|
||||||
prioritizedVersions = append(prioritizedVersions, unprioritizedVersions...)
|
|
||||||
m.RegisterVersions(prioritizedVersions)
|
|
||||||
gmf.prioritizedVersionList = prioritizedVersions
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gmf *GroupMetaFactory) newRESTMapper(scheme *runtime.Scheme, externalVersions []schema.GroupVersion, groupMeta *apimachinery.GroupMeta) meta.RESTMapper {
|
|
||||||
// the list of kinds that are scoped at the root of the api hierarchy
|
|
||||||
// if a kind is not enumerated here, it is assumed to have a namespace scope
|
|
||||||
rootScoped := sets.NewString()
|
|
||||||
if gmf.GroupArgs.RootScopedKinds != nil {
|
|
||||||
rootScoped = gmf.GroupArgs.RootScopedKinds
|
|
||||||
}
|
|
||||||
ignoredKinds := sets.NewString()
|
|
||||||
if gmf.GroupArgs.IgnoredKinds != nil {
|
|
||||||
ignoredKinds = gmf.GroupArgs.IgnoredKinds
|
|
||||||
}
|
|
||||||
|
|
||||||
return meta.NewDefaultRESTMapperFromScheme(
|
|
||||||
externalVersions,
|
|
||||||
groupMeta.InterfacesFor,
|
|
||||||
gmf.GroupArgs.ImportPrefix,
|
|
||||||
ignoredKinds,
|
|
||||||
rootScoped,
|
|
||||||
scheme,
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Enable enables group versions that are allowed, adds methods to the scheme, etc.
|
|
||||||
func (gmf *GroupMetaFactory) Enable(m *registered.APIRegistrationManager, scheme *runtime.Scheme) error {
|
|
||||||
externalVersions := []schema.GroupVersion{}
|
|
||||||
for _, v := range gmf.prioritizedVersionList {
|
|
||||||
if !m.IsAllowedVersion(v) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
externalVersions = append(externalVersions, v)
|
|
||||||
if err := m.EnableVersions(v); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
gmf.VersionArgs[v.Version].AddToScheme(scheme)
|
|
||||||
}
|
|
||||||
if len(externalVersions) == 0 {
|
|
||||||
glog.V(4).Infof("No version is registered for group %v", gmf.GroupArgs.GroupName)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
if gmf.GroupArgs.AddInternalObjectsToScheme != nil {
|
|
||||||
gmf.GroupArgs.AddInternalObjectsToScheme(scheme)
|
|
||||||
}
|
|
||||||
|
|
||||||
preferredExternalVersion := externalVersions[0]
|
|
||||||
accessor := meta.NewAccessor()
|
|
||||||
|
|
||||||
groupMeta := &apimachinery.GroupMeta{
|
|
||||||
GroupVersion: preferredExternalVersion,
|
|
||||||
GroupVersions: externalVersions,
|
|
||||||
SelfLinker: runtime.SelfLinker(accessor),
|
|
||||||
}
|
|
||||||
for _, v := range externalVersions {
|
|
||||||
gvf := gmf.VersionArgs[v.Version]
|
|
||||||
if err := groupMeta.AddVersionInterfaces(
|
|
||||||
schema.GroupVersion{Group: gvf.GroupName, Version: gvf.VersionName},
|
|
||||||
&meta.VersionInterfaces{
|
|
||||||
ObjectConvertor: scheme,
|
|
||||||
MetadataAccessor: accessor,
|
|
||||||
},
|
|
||||||
); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
groupMeta.InterfacesFor = groupMeta.DefaultInterfacesFor
|
|
||||||
groupMeta.RESTMapper = gmf.newRESTMapper(scheme, externalVersions, groupMeta)
|
|
||||||
|
|
||||||
if err := m.RegisterGroup(*groupMeta); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterAndEnable is provided only to allow this code to get added in multiple steps.
|
|
||||||
// It's really bad that this is called in init() methods, but supporting this
|
|
||||||
// temporarily lets us do the change incrementally.
|
|
||||||
func (gmf *GroupMetaFactory) RegisterAndEnable(registry *registered.APIRegistrationManager, scheme *runtime.Scheme) error {
|
|
||||||
if err := gmf.Register(registry); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := gmf.Enable(registry, scheme); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 apimachinery contains the generic API machinery code that
|
|
||||||
// is common to both server and clients.
|
|
||||||
// This package should never import specific API objects.
|
|
||||||
package apimachinery
|
|
||||||
@@ -1,376 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 to keep track of API Versions that can be registered and are enabled in api.Scheme.
|
|
||||||
package registered
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/golang/glog"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/api/meta"
|
|
||||||
"k8s.io/apimachinery/pkg/apimachinery"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/util/sets"
|
|
||||||
)
|
|
||||||
|
|
||||||
// APIRegistrationManager provides the concept of what API groups are enabled.
|
|
||||||
//
|
|
||||||
// TODO: currently, it also provides a "registered" concept. But it's wrong to
|
|
||||||
// have both concepts in the same object. Therefore the "announced" package is
|
|
||||||
// going to take over the registered concept. After all the install packages
|
|
||||||
// are switched to using the announce package instead of this package, then we
|
|
||||||
// can combine the registered/enabled concepts in this object. Simplifying this
|
|
||||||
// isn't easy right now because there are so many callers of this package.
|
|
||||||
type APIRegistrationManager struct {
|
|
||||||
// registeredGroupVersions stores all API group versions for which RegisterGroup is called.
|
|
||||||
registeredVersions map[schema.GroupVersion]struct{}
|
|
||||||
|
|
||||||
// thirdPartyGroupVersions are API versions which are dynamically
|
|
||||||
// registered (and unregistered) via API calls to the apiserver
|
|
||||||
thirdPartyGroupVersions []schema.GroupVersion
|
|
||||||
|
|
||||||
// enabledVersions represents all enabled API versions. It should be a
|
|
||||||
// subset of registeredVersions. Please call EnableVersions() to add
|
|
||||||
// enabled versions.
|
|
||||||
enabledVersions map[schema.GroupVersion]struct{}
|
|
||||||
|
|
||||||
// map of group meta for all groups.
|
|
||||||
groupMetaMap map[string]*apimachinery.GroupMeta
|
|
||||||
|
|
||||||
// envRequestedVersions represents the versions requested via the
|
|
||||||
// KUBE_API_VERSIONS environment variable. The install package of each group
|
|
||||||
// checks this list before add their versions to the latest package and
|
|
||||||
// Scheme. This list is small and order matters, so represent as a slice
|
|
||||||
envRequestedVersions []schema.GroupVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewAPIRegistrationManager constructs a new manager. The argument ought to be
|
|
||||||
// the value of the KUBE_API_VERSIONS env var, or a value of this which you
|
|
||||||
// wish to test.
|
|
||||||
func NewAPIRegistrationManager(kubeAPIVersions string) (*APIRegistrationManager, error) {
|
|
||||||
m := &APIRegistrationManager{
|
|
||||||
registeredVersions: map[schema.GroupVersion]struct{}{},
|
|
||||||
thirdPartyGroupVersions: []schema.GroupVersion{},
|
|
||||||
enabledVersions: map[schema.GroupVersion]struct{}{},
|
|
||||||
groupMetaMap: map[string]*apimachinery.GroupMeta{},
|
|
||||||
envRequestedVersions: []schema.GroupVersion{},
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(kubeAPIVersions) != 0 {
|
|
||||||
for _, version := range strings.Split(kubeAPIVersions, ",") {
|
|
||||||
gv, err := schema.ParseGroupVersion(version)
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("invalid api version: %s in KUBE_API_VERSIONS: %s.",
|
|
||||||
version, kubeAPIVersions)
|
|
||||||
}
|
|
||||||
m.envRequestedVersions = append(m.envRequestedVersions, gv)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return m, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewOrDie(kubeAPIVersions string) *APIRegistrationManager {
|
|
||||||
m, err := NewAPIRegistrationManager(kubeAPIVersions)
|
|
||||||
if err != nil {
|
|
||||||
glog.Fatalf("Could not construct version manager: %v (KUBE_API_VERSIONS=%q)", err, kubeAPIVersions)
|
|
||||||
}
|
|
||||||
return m
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterVersions adds the given group versions to the list of registered group versions.
|
|
||||||
func (m *APIRegistrationManager) RegisterVersions(availableVersions []schema.GroupVersion) {
|
|
||||||
for _, v := range availableVersions {
|
|
||||||
m.registeredVersions[v] = struct{}{}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterGroup adds the given group to the list of registered groups.
|
|
||||||
func (m *APIRegistrationManager) RegisterGroup(groupMeta apimachinery.GroupMeta) error {
|
|
||||||
groupName := groupMeta.GroupVersion.Group
|
|
||||||
if _, found := m.groupMetaMap[groupName]; found {
|
|
||||||
return fmt.Errorf("group %q is already registered in groupsMap: %v", groupName, m.groupMetaMap)
|
|
||||||
}
|
|
||||||
m.groupMetaMap[groupName] = &groupMeta
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// EnableVersions adds the versions for the given group to the list of enabled versions.
|
|
||||||
// Note that the caller should call RegisterGroup before calling this method.
|
|
||||||
// The caller of this function is responsible to add the versions to scheme and RESTMapper.
|
|
||||||
func (m *APIRegistrationManager) EnableVersions(versions ...schema.GroupVersion) error {
|
|
||||||
var unregisteredVersions []schema.GroupVersion
|
|
||||||
for _, v := range versions {
|
|
||||||
if _, found := m.registeredVersions[v]; !found {
|
|
||||||
unregisteredVersions = append(unregisteredVersions, v)
|
|
||||||
}
|
|
||||||
m.enabledVersions[v] = struct{}{}
|
|
||||||
}
|
|
||||||
if len(unregisteredVersions) != 0 {
|
|
||||||
return fmt.Errorf("Please register versions before enabling them: %v", unregisteredVersions)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsAllowedVersion returns if the version is allowed by the KUBE_API_VERSIONS
|
|
||||||
// environment variable. If the environment variable is empty, then it always
|
|
||||||
// returns true.
|
|
||||||
func (m *APIRegistrationManager) IsAllowedVersion(v schema.GroupVersion) bool {
|
|
||||||
if len(m.envRequestedVersions) == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
for _, envGV := range m.envRequestedVersions {
|
|
||||||
if v == envGV {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsEnabledVersion returns if a version is enabled.
|
|
||||||
func (m *APIRegistrationManager) IsEnabledVersion(v schema.GroupVersion) bool {
|
|
||||||
_, found := m.enabledVersions[v]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
// EnabledVersions returns all enabled versions. Groups are randomly ordered, but versions within groups
|
|
||||||
// are priority order from best to worst
|
|
||||||
func (m *APIRegistrationManager) EnabledVersions() []schema.GroupVersion {
|
|
||||||
ret := []schema.GroupVersion{}
|
|
||||||
for _, groupMeta := range m.groupMetaMap {
|
|
||||||
for _, version := range groupMeta.GroupVersions {
|
|
||||||
if m.IsEnabledVersion(version) {
|
|
||||||
ret = append(ret, version)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
// EnabledVersionsForGroup returns all enabled versions for a group in order of best to worst
|
|
||||||
func (m *APIRegistrationManager) EnabledVersionsForGroup(group string) []schema.GroupVersion {
|
|
||||||
groupMeta, ok := m.groupMetaMap[group]
|
|
||||||
if !ok {
|
|
||||||
return []schema.GroupVersion{}
|
|
||||||
}
|
|
||||||
|
|
||||||
ret := []schema.GroupVersion{}
|
|
||||||
for _, version := range groupMeta.GroupVersions {
|
|
||||||
if m.IsEnabledVersion(version) {
|
|
||||||
ret = append(ret, version)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group returns the metadata of a group if the group is registered, otherwise
|
|
||||||
// an error is returned.
|
|
||||||
func (m *APIRegistrationManager) Group(group string) (*apimachinery.GroupMeta, error) {
|
|
||||||
groupMeta, found := m.groupMetaMap[group]
|
|
||||||
if !found {
|
|
||||||
return nil, fmt.Errorf("group %v has not been registered", group)
|
|
||||||
}
|
|
||||||
groupMetaCopy := *groupMeta
|
|
||||||
return &groupMetaCopy, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsRegistered takes a string and determines if it's one of the registered groups
|
|
||||||
func (m *APIRegistrationManager) IsRegistered(group string) bool {
|
|
||||||
_, found := m.groupMetaMap[group]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsRegisteredVersion returns if a version is registered.
|
|
||||||
func (m *APIRegistrationManager) IsRegisteredVersion(v schema.GroupVersion) bool {
|
|
||||||
_, found := m.registeredVersions[v]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisteredGroupVersions returns all registered group versions.
|
|
||||||
func (m *APIRegistrationManager) RegisteredGroupVersions() []schema.GroupVersion {
|
|
||||||
ret := []schema.GroupVersion{}
|
|
||||||
for groupVersion := range m.registeredVersions {
|
|
||||||
ret = append(ret, groupVersion)
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsThirdPartyAPIGroupVersion returns true if the api version is a user-registered group/version.
|
|
||||||
func (m *APIRegistrationManager) IsThirdPartyAPIGroupVersion(gv schema.GroupVersion) bool {
|
|
||||||
for ix := range m.thirdPartyGroupVersions {
|
|
||||||
if m.thirdPartyGroupVersions[ix] == gv {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddThirdPartyAPIGroupVersions sets the list of third party versions,
|
|
||||||
// registers them in the API machinery and enables them.
|
|
||||||
// Skips GroupVersions that are already registered.
|
|
||||||
// Returns the list of GroupVersions that were skipped.
|
|
||||||
func (m *APIRegistrationManager) AddThirdPartyAPIGroupVersions(gvs ...schema.GroupVersion) []schema.GroupVersion {
|
|
||||||
filteredGVs := []schema.GroupVersion{}
|
|
||||||
skippedGVs := []schema.GroupVersion{}
|
|
||||||
for ix := range gvs {
|
|
||||||
if !m.IsRegisteredVersion(gvs[ix]) {
|
|
||||||
filteredGVs = append(filteredGVs, gvs[ix])
|
|
||||||
} else {
|
|
||||||
glog.V(3).Infof("Skipping %s, because its already registered", gvs[ix].String())
|
|
||||||
skippedGVs = append(skippedGVs, gvs[ix])
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if len(filteredGVs) == 0 {
|
|
||||||
return skippedGVs
|
|
||||||
}
|
|
||||||
m.RegisterVersions(filteredGVs)
|
|
||||||
m.EnableVersions(filteredGVs...)
|
|
||||||
m.thirdPartyGroupVersions = append(m.thirdPartyGroupVersions, filteredGVs...)
|
|
||||||
|
|
||||||
return skippedGVs
|
|
||||||
}
|
|
||||||
|
|
||||||
// InterfacesFor is a union meta.VersionInterfacesFunc func for all registered types
|
|
||||||
func (m *APIRegistrationManager) InterfacesFor(version schema.GroupVersion) (*meta.VersionInterfaces, error) {
|
|
||||||
groupMeta, err := m.Group(version.Group)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return groupMeta.InterfacesFor(version)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: This is an expedient function, because we don't check if a Group is
|
|
||||||
// supported throughout the code base. We will abandon this function and
|
|
||||||
// checking the error returned by the Group() function.
|
|
||||||
func (m *APIRegistrationManager) GroupOrDie(group string) *apimachinery.GroupMeta {
|
|
||||||
groupMeta, found := m.groupMetaMap[group]
|
|
||||||
if !found {
|
|
||||||
if group == "" {
|
|
||||||
panic("The legacy v1 API is not registered.")
|
|
||||||
} else {
|
|
||||||
panic(fmt.Sprintf("Group %s is not registered.", group))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
groupMetaCopy := *groupMeta
|
|
||||||
return &groupMetaCopy
|
|
||||||
}
|
|
||||||
|
|
||||||
// RESTMapper returns a union RESTMapper of all known types with priorities chosen in the following order:
|
|
||||||
// 1. if KUBE_API_VERSIONS is specified, then KUBE_API_VERSIONS in order, OR
|
|
||||||
// 1. legacy kube group preferred version, extensions preferred version, metrics perferred version, legacy
|
|
||||||
// kube any version, extensions any version, metrics any version, all other groups alphabetical preferred version,
|
|
||||||
// all other groups alphabetical.
|
|
||||||
func (m *APIRegistrationManager) RESTMapper(versionPatterns ...schema.GroupVersion) meta.RESTMapper {
|
|
||||||
unionMapper := meta.MultiRESTMapper{}
|
|
||||||
unionedGroups := sets.NewString()
|
|
||||||
for enabledVersion := range m.enabledVersions {
|
|
||||||
if !unionedGroups.Has(enabledVersion.Group) {
|
|
||||||
unionedGroups.Insert(enabledVersion.Group)
|
|
||||||
groupMeta := m.groupMetaMap[enabledVersion.Group]
|
|
||||||
unionMapper = append(unionMapper, groupMeta.RESTMapper)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(versionPatterns) != 0 {
|
|
||||||
resourcePriority := []schema.GroupVersionResource{}
|
|
||||||
kindPriority := []schema.GroupVersionKind{}
|
|
||||||
for _, versionPriority := range versionPatterns {
|
|
||||||
resourcePriority = append(resourcePriority, versionPriority.WithResource(meta.AnyResource))
|
|
||||||
kindPriority = append(kindPriority, versionPriority.WithKind(meta.AnyKind))
|
|
||||||
}
|
|
||||||
|
|
||||||
return meta.PriorityRESTMapper{Delegate: unionMapper, ResourcePriority: resourcePriority, KindPriority: kindPriority}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(m.envRequestedVersions) != 0 {
|
|
||||||
resourcePriority := []schema.GroupVersionResource{}
|
|
||||||
kindPriority := []schema.GroupVersionKind{}
|
|
||||||
|
|
||||||
for _, versionPriority := range m.envRequestedVersions {
|
|
||||||
resourcePriority = append(resourcePriority, versionPriority.WithResource(meta.AnyResource))
|
|
||||||
kindPriority = append(kindPriority, versionPriority.WithKind(meta.AnyKind))
|
|
||||||
}
|
|
||||||
|
|
||||||
return meta.PriorityRESTMapper{Delegate: unionMapper, ResourcePriority: resourcePriority, KindPriority: kindPriority}
|
|
||||||
}
|
|
||||||
|
|
||||||
prioritizedGroups := []string{"", "extensions", "metrics"}
|
|
||||||
resourcePriority, kindPriority := m.prioritiesForGroups(prioritizedGroups...)
|
|
||||||
|
|
||||||
prioritizedGroupsSet := sets.NewString(prioritizedGroups...)
|
|
||||||
remainingGroups := sets.String{}
|
|
||||||
for enabledVersion := range m.enabledVersions {
|
|
||||||
if !prioritizedGroupsSet.Has(enabledVersion.Group) {
|
|
||||||
remainingGroups.Insert(enabledVersion.Group)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
remainingResourcePriority, remainingKindPriority := m.prioritiesForGroups(remainingGroups.List()...)
|
|
||||||
resourcePriority = append(resourcePriority, remainingResourcePriority...)
|
|
||||||
kindPriority = append(kindPriority, remainingKindPriority...)
|
|
||||||
|
|
||||||
return meta.PriorityRESTMapper{Delegate: unionMapper, ResourcePriority: resourcePriority, KindPriority: kindPriority}
|
|
||||||
}
|
|
||||||
|
|
||||||
// prioritiesForGroups returns the resource and kind priorities for a PriorityRESTMapper, preferring the preferred version of each group first,
|
|
||||||
// then any non-preferred version of the group second.
|
|
||||||
func (m *APIRegistrationManager) prioritiesForGroups(groups ...string) ([]schema.GroupVersionResource, []schema.GroupVersionKind) {
|
|
||||||
resourcePriority := []schema.GroupVersionResource{}
|
|
||||||
kindPriority := []schema.GroupVersionKind{}
|
|
||||||
|
|
||||||
for _, group := range groups {
|
|
||||||
availableVersions := m.EnabledVersionsForGroup(group)
|
|
||||||
if len(availableVersions) > 0 {
|
|
||||||
resourcePriority = append(resourcePriority, availableVersions[0].WithResource(meta.AnyResource))
|
|
||||||
kindPriority = append(kindPriority, availableVersions[0].WithKind(meta.AnyKind))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, group := range groups {
|
|
||||||
resourcePriority = append(resourcePriority, schema.GroupVersionResource{Group: group, Version: meta.AnyVersion, Resource: meta.AnyResource})
|
|
||||||
kindPriority = append(kindPriority, schema.GroupVersionKind{Group: group, Version: meta.AnyVersion, Kind: meta.AnyKind})
|
|
||||||
}
|
|
||||||
|
|
||||||
return resourcePriority, kindPriority
|
|
||||||
}
|
|
||||||
|
|
||||||
// AllPreferredGroupVersions returns the preferred versions of all registered
|
|
||||||
// groups in the form of "group1/version1,group2/version2,..."
|
|
||||||
func (m *APIRegistrationManager) AllPreferredGroupVersions() string {
|
|
||||||
if len(m.groupMetaMap) == 0 {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
var defaults []string
|
|
||||||
for _, groupMeta := range m.groupMetaMap {
|
|
||||||
defaults = append(defaults, groupMeta.GroupVersion.String())
|
|
||||||
}
|
|
||||||
sort.Strings(defaults)
|
|
||||||
return strings.Join(defaults, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// ValidateEnvRequestedVersions returns a list of versions that are requested in
|
|
||||||
// the KUBE_API_VERSIONS environment variable, but not enabled.
|
|
||||||
func (m *APIRegistrationManager) ValidateEnvRequestedVersions() []schema.GroupVersion {
|
|
||||||
var missingVersions []schema.GroupVersion
|
|
||||||
for _, v := range m.envRequestedVersions {
|
|
||||||
if _, found := m.enabledVersions[v]; !found {
|
|
||||||
missingVersions = append(missingVersions, v)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return missingVersions
|
|
||||||
}
|
|
||||||
@@ -1,87 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 apimachinery
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/api/meta"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// GroupMeta stores the metadata of a group.
|
|
||||||
type GroupMeta struct {
|
|
||||||
// GroupVersion represents the preferred version of the group.
|
|
||||||
GroupVersion schema.GroupVersion
|
|
||||||
|
|
||||||
// GroupVersions is Group + all versions in that group.
|
|
||||||
GroupVersions []schema.GroupVersion
|
|
||||||
|
|
||||||
// SelfLinker can set or get the SelfLink field of all API types.
|
|
||||||
// TODO: when versioning changes, make this part of each API definition.
|
|
||||||
// TODO(lavalamp): Combine SelfLinker & ResourceVersioner interfaces, force all uses
|
|
||||||
// to go through the InterfacesFor method below.
|
|
||||||
SelfLinker runtime.SelfLinker
|
|
||||||
|
|
||||||
// RESTMapper provides the default mapping between REST paths and the objects declared in api.Scheme and all known
|
|
||||||
// versions.
|
|
||||||
RESTMapper meta.RESTMapper
|
|
||||||
|
|
||||||
// InterfacesFor returns the default Codec and ResourceVersioner for a given version
|
|
||||||
// string, or an error if the version is not known.
|
|
||||||
// TODO: make this stop being a func pointer and always use the default
|
|
||||||
// function provided below once every place that populates this field has been changed.
|
|
||||||
InterfacesFor func(version schema.GroupVersion) (*meta.VersionInterfaces, error)
|
|
||||||
|
|
||||||
// InterfacesByVersion stores the per-version interfaces.
|
|
||||||
InterfacesByVersion map[schema.GroupVersion]*meta.VersionInterfaces
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultInterfacesFor returns the default Codec and ResourceVersioner for a given version
|
|
||||||
// string, or an error if the version is not known.
|
|
||||||
// TODO: Remove the "Default" prefix.
|
|
||||||
func (gm *GroupMeta) DefaultInterfacesFor(version schema.GroupVersion) (*meta.VersionInterfaces, error) {
|
|
||||||
if v, ok := gm.InterfacesByVersion[version]; ok {
|
|
||||||
return v, nil
|
|
||||||
}
|
|
||||||
return nil, fmt.Errorf("unsupported storage version: %s (valid: %v)", version, gm.GroupVersions)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddVersionInterfaces adds the given version to the group. Only call during
|
|
||||||
// init, after that GroupMeta objects should be immutable. Not thread safe.
|
|
||||||
// (If you use this, be sure to set .InterfacesFor = .DefaultInterfacesFor)
|
|
||||||
// TODO: remove the "Interfaces" suffix and make this also maintain the
|
|
||||||
// .GroupVersions member.
|
|
||||||
func (gm *GroupMeta) AddVersionInterfaces(version schema.GroupVersion, interfaces *meta.VersionInterfaces) error {
|
|
||||||
if e, a := gm.GroupVersion.Group, version.Group; a != e {
|
|
||||||
return fmt.Errorf("got a version in group %v, but am in group %v", a, e)
|
|
||||||
}
|
|
||||||
if gm.InterfacesByVersion == nil {
|
|
||||||
gm.InterfacesByVersion = make(map[schema.GroupVersion]*meta.VersionInterfaces)
|
|
||||||
}
|
|
||||||
gm.InterfacesByVersion[version] = interfaces
|
|
||||||
|
|
||||||
// TODO: refactor to make the below error not possible, this function
|
|
||||||
// should *set* GroupVersions rather than depend on it.
|
|
||||||
for _, v := range gm.GroupVersions {
|
|
||||||
if v == version {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return fmt.Errorf("added a version interface without the corresponding version %v being in the list %#v", version, gm.GroupVersions)
|
|
||||||
}
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
reviewers:
|
|
||||||
- thockin
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
- deads2k
|
|
||||||
- brendandburns
|
|
||||||
- caesarxuchao
|
|
||||||
- liggitt
|
|
||||||
- nikhiljindal
|
|
||||||
- gmarek
|
|
||||||
- erictune
|
|
||||||
- davidopp
|
|
||||||
- sttts
|
|
||||||
- quinton-hoole
|
|
||||||
- kargakis
|
|
||||||
- luxas
|
|
||||||
- janetkuo
|
|
||||||
- justinsb
|
|
||||||
- ncdc
|
|
||||||
- timothysc
|
|
||||||
- soltysh
|
|
||||||
- dims
|
|
||||||
- madhusudancs
|
|
||||||
- hongchaodeng
|
|
||||||
- krousey
|
|
||||||
- mml
|
|
||||||
- mbohlool
|
|
||||||
- david-mcmahon
|
|
||||||
- therc
|
|
||||||
- mqliang
|
|
||||||
- kevin-wangzefeng
|
|
||||||
- jianhuiz
|
|
||||||
- feihujiang
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// +groupName=meta.k8s.io
|
|
||||||
package v1
|
|
||||||
@@ -1,47 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Duration is a wrapper around time.Duration which supports correct
|
|
||||||
// marshaling to YAML and JSON. In particular, it marshals into strings, which
|
|
||||||
// can be used as map keys in json.
|
|
||||||
type Duration struct {
|
|
||||||
time.Duration `protobuf:"varint,1,opt,name=duration,casttype=time.Duration"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON implements the json.Unmarshaller interface.
|
|
||||||
func (d *Duration) UnmarshalJSON(b []byte) error {
|
|
||||||
var str string
|
|
||||||
json.Unmarshal(b, &str)
|
|
||||||
|
|
||||||
pd, err := time.ParseDuration(str)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
d.Duration = pd
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON implements the json.Marshaler interface.
|
|
||||||
func (d Duration) MarshalJSON() ([]byte, error) {
|
|
||||||
return json.Marshal(d.Duration.String())
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,671 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
|
|
||||||
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
|
|
||||||
|
|
||||||
syntax = 'proto2';
|
|
||||||
|
|
||||||
package k8s.io.apimachinery.pkg.apis.meta.v1;
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/runtime/generated.proto";
|
|
||||||
import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";
|
|
||||||
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
|
|
||||||
|
|
||||||
// Package-wide variables from generator "generated".
|
|
||||||
option go_package = "v1";
|
|
||||||
|
|
||||||
// APIGroup contains the name, the supported versions, and the preferred version
|
|
||||||
// of a group.
|
|
||||||
message APIGroup {
|
|
||||||
// name is the name of the group.
|
|
||||||
optional string name = 1;
|
|
||||||
|
|
||||||
// versions are the versions supported in this group.
|
|
||||||
repeated GroupVersionForDiscovery versions = 2;
|
|
||||||
|
|
||||||
// preferredVersion is the version preferred by the API server, which
|
|
||||||
// probably is the storage version.
|
|
||||||
// +optional
|
|
||||||
optional GroupVersionForDiscovery preferredVersion = 3;
|
|
||||||
|
|
||||||
// a map of client CIDR to server address that is serving this group.
|
|
||||||
// This is to help clients reach servers in the most network-efficient way possible.
|
|
||||||
// Clients can use the appropriate server address as per the CIDR that they match.
|
|
||||||
// In case of multiple matches, clients should use the longest matching CIDR.
|
|
||||||
// The server returns only those CIDRs that it thinks that the client can match.
|
|
||||||
// For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP.
|
|
||||||
// Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
|
|
||||||
repeated ServerAddressByClientCIDR serverAddressByClientCIDRs = 4;
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIGroupList is a list of APIGroup, to allow clients to discover the API at
|
|
||||||
// /apis.
|
|
||||||
message APIGroupList {
|
|
||||||
// groups is a list of APIGroup.
|
|
||||||
repeated APIGroup groups = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIResource specifies the name of a resource and whether it is namespaced.
|
|
||||||
message APIResource {
|
|
||||||
// name is the name of the resource.
|
|
||||||
optional string name = 1;
|
|
||||||
|
|
||||||
// namespaced indicates if a resource is namespaced or not.
|
|
||||||
optional bool namespaced = 2;
|
|
||||||
|
|
||||||
// kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')
|
|
||||||
optional string kind = 3;
|
|
||||||
|
|
||||||
// verbs is a list of supported kube verbs (this includes get, list, watch, create,
|
|
||||||
// update, patch, delete, deletecollection, and proxy)
|
|
||||||
optional Verbs verbs = 4;
|
|
||||||
|
|
||||||
// shortNames is a list of suggested short names of the resource.
|
|
||||||
repeated string shortNames = 5;
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIResourceList is a list of APIResource, it is used to expose the name of the
|
|
||||||
// resources supported in a specific group and version, and if the resource
|
|
||||||
// is namespaced.
|
|
||||||
message APIResourceList {
|
|
||||||
// groupVersion is the group and version this APIResourceList is for.
|
|
||||||
optional string groupVersion = 1;
|
|
||||||
|
|
||||||
// resources contains the name of the resources and if they are namespaced.
|
|
||||||
repeated APIResource resources = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIVersions lists the versions that are available, to allow clients to
|
|
||||||
// discover the API at /api, which is the root path of the legacy v1 API.
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message APIVersions {
|
|
||||||
// versions are the api versions that are available.
|
|
||||||
repeated string versions = 1;
|
|
||||||
|
|
||||||
// a map of client CIDR to server address that is serving this group.
|
|
||||||
// This is to help clients reach servers in the most network-efficient way possible.
|
|
||||||
// Clients can use the appropriate server address as per the CIDR that they match.
|
|
||||||
// In case of multiple matches, clients should use the longest matching CIDR.
|
|
||||||
// The server returns only those CIDRs that it thinks that the client can match.
|
|
||||||
// For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP.
|
|
||||||
// Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
|
|
||||||
repeated ServerAddressByClientCIDR serverAddressByClientCIDRs = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// DeleteOptions may be provided when deleting an API object.
|
|
||||||
message DeleteOptions {
|
|
||||||
// The duration in seconds before the object should be deleted. Value must be non-negative integer.
|
|
||||||
// The value zero indicates delete immediately. If this value is nil, the default grace period for the
|
|
||||||
// specified type will be used.
|
|
||||||
// Defaults to a per object value if not specified. zero means delete immediately.
|
|
||||||
// +optional
|
|
||||||
optional int64 gracePeriodSeconds = 1;
|
|
||||||
|
|
||||||
// Must be fulfilled before a deletion is carried out. If not possible, a 409 Conflict status will be
|
|
||||||
// returned.
|
|
||||||
// +optional
|
|
||||||
optional Preconditions preconditions = 2;
|
|
||||||
|
|
||||||
// Should the dependent objects be orphaned. If true/false, the "orphan"
|
|
||||||
// finalizer will be added to/removed from the object's finalizers list.
|
|
||||||
// +optional
|
|
||||||
optional bool orphanDependents = 3;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Duration is a wrapper around time.Duration which supports correct
|
|
||||||
// marshaling to YAML and JSON. In particular, it marshals into strings, which
|
|
||||||
// can be used as map keys in json.
|
|
||||||
message Duration {
|
|
||||||
optional int64 duration = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ExportOptions is the query options to the standard REST get call.
|
|
||||||
message ExportOptions {
|
|
||||||
// Should this value be exported. Export strips fields that a user can not specify.
|
|
||||||
optional bool export = 1;
|
|
||||||
|
|
||||||
// Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'.
|
|
||||||
optional bool exact = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GetOptions is the standard query options to the standard REST get call.
|
|
||||||
message GetOptions {
|
|
||||||
// When specified:
|
|
||||||
// - if unset, then the result is returned from remote storage based on quorum-read flag;
|
|
||||||
// - if it's 0, then we simply return what we currently have in cache, no guarantee;
|
|
||||||
// - if set to non zero, then the result is at least as fresh as given rv.
|
|
||||||
optional string resourceVersion = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupKind specifies a Group and a Kind, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message GroupKind {
|
|
||||||
optional string group = 1;
|
|
||||||
|
|
||||||
optional string kind = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupResource specifies a Group and a Resource, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message GroupResource {
|
|
||||||
optional string group = 1;
|
|
||||||
|
|
||||||
optional string resource = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersion contains the "group" and the "version", which uniquely identifies the API.
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message GroupVersion {
|
|
||||||
optional string group = 1;
|
|
||||||
|
|
||||||
optional string version = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersion contains the "group/version" and "version" string of a version.
|
|
||||||
// It is made a struct to keep extensibility.
|
|
||||||
message GroupVersionForDiscovery {
|
|
||||||
// groupVersion specifies the API group and version in the form "group/version"
|
|
||||||
optional string groupVersion = 1;
|
|
||||||
|
|
||||||
// version specifies the version in the form of "version". This is to save
|
|
||||||
// the clients the trouble of splitting the GroupVersion.
|
|
||||||
optional string version = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionKind unambiguously identifies a kind. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coersion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message GroupVersionKind {
|
|
||||||
optional string group = 1;
|
|
||||||
|
|
||||||
optional string version = 2;
|
|
||||||
|
|
||||||
optional string kind = 3;
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionResource unambiguously identifies a resource. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coersion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message GroupVersionResource {
|
|
||||||
optional string group = 1;
|
|
||||||
|
|
||||||
optional string version = 2;
|
|
||||||
|
|
||||||
optional string resource = 3;
|
|
||||||
}
|
|
||||||
|
|
||||||
// A label selector is a label query over a set of resources. The result of matchLabels and
|
|
||||||
// matchExpressions are ANDed. An empty label selector matches all objects. A null
|
|
||||||
// label selector matches no objects.
|
|
||||||
message LabelSelector {
|
|
||||||
// matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
|
|
||||||
// map is equivalent to an element of matchExpressions, whose key field is "key", the
|
|
||||||
// operator is "In", and the values array contains only "value". The requirements are ANDed.
|
|
||||||
// +optional
|
|
||||||
map<string, string> matchLabels = 1;
|
|
||||||
|
|
||||||
// matchExpressions is a list of label selector requirements. The requirements are ANDed.
|
|
||||||
// +optional
|
|
||||||
repeated LabelSelectorRequirement matchExpressions = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// A label selector requirement is a selector that contains values, a key, and an operator that
|
|
||||||
// relates the key and values.
|
|
||||||
message LabelSelectorRequirement {
|
|
||||||
// key is the label key that the selector applies to.
|
|
||||||
optional string key = 1;
|
|
||||||
|
|
||||||
// operator represents a key's relationship to a set of values.
|
|
||||||
// Valid operators ard In, NotIn, Exists and DoesNotExist.
|
|
||||||
optional string operator = 2;
|
|
||||||
|
|
||||||
// values is an array of string values. If the operator is In or NotIn,
|
|
||||||
// the values array must be non-empty. If the operator is Exists or DoesNotExist,
|
|
||||||
// the values array must be empty. This array is replaced during a strategic
|
|
||||||
// merge patch.
|
|
||||||
// +optional
|
|
||||||
repeated string values = 3;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListMeta describes metadata that synthetic resources must have, including lists and
|
|
||||||
// various status objects. A resource may have only one of {ObjectMeta, ListMeta}.
|
|
||||||
message ListMeta {
|
|
||||||
// SelfLink is a URL representing this object.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
optional string selfLink = 1;
|
|
||||||
|
|
||||||
// String that identifies the server's internal version of this object that
|
|
||||||
// can be used by clients to determine when objects have changed.
|
|
||||||
// Value must be treated as opaque by clients and passed unmodified back to the server.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency
|
|
||||||
// +optional
|
|
||||||
optional string resourceVersion = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListOptions is the query options to a standard REST list call.
|
|
||||||
message ListOptions {
|
|
||||||
// A selector to restrict the list of returned objects by their labels.
|
|
||||||
// Defaults to everything.
|
|
||||||
// +optional
|
|
||||||
optional string labelSelector = 1;
|
|
||||||
|
|
||||||
// A selector to restrict the list of returned objects by their fields.
|
|
||||||
// Defaults to everything.
|
|
||||||
// +optional
|
|
||||||
optional string fieldSelector = 2;
|
|
||||||
|
|
||||||
// Watch for changes to the described resources and return them as a stream of
|
|
||||||
// add, update, and remove notifications. Specify resourceVersion.
|
|
||||||
// +optional
|
|
||||||
optional bool watch = 3;
|
|
||||||
|
|
||||||
// When specified with a watch call, shows changes that occur after that particular version of a resource.
|
|
||||||
// Defaults to changes from the beginning of history.
|
|
||||||
// When specified for list:
|
|
||||||
// - if unset, then the result is returned from remote storage based on quorum-read flag;
|
|
||||||
// - if it's 0, then we simply return what we currently have in cache, no guarantee;
|
|
||||||
// - if set to non zero, then the result is at least as fresh as given rv.
|
|
||||||
// +optional
|
|
||||||
optional string resourceVersion = 4;
|
|
||||||
|
|
||||||
// Timeout for the list/watch call.
|
|
||||||
// +optional
|
|
||||||
optional int64 timeoutSeconds = 5;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectMeta is metadata that all persisted resources must have, which includes all objects
|
|
||||||
// users must create.
|
|
||||||
message ObjectMeta {
|
|
||||||
// Name must be unique within a namespace. Is required when creating resources, although
|
|
||||||
// some resources may allow a client to request the generation of an appropriate name
|
|
||||||
// automatically. Name is primarily intended for creation idempotence and configuration
|
|
||||||
// definition.
|
|
||||||
// Cannot be updated.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
|
|
||||||
// +optional
|
|
||||||
optional string name = 1;
|
|
||||||
|
|
||||||
// GenerateName is an optional prefix, used by the server, to generate a unique
|
|
||||||
// name ONLY IF the Name field has not been provided.
|
|
||||||
// If this field is used, the name returned to the client will be different
|
|
||||||
// than the name passed. This value will also be combined with a unique suffix.
|
|
||||||
// The provided value has the same validation rules as the Name field,
|
|
||||||
// and may be truncated by the length of the suffix required to make the value
|
|
||||||
// unique on the server.
|
|
||||||
//
|
|
||||||
// If this field is specified and the generated name exists, the server will
|
|
||||||
// NOT return a 409 - instead, it will either return 201 Created or 500 with Reason
|
|
||||||
// ServerTimeout indicating a unique name could not be found in the time allotted, and the client
|
|
||||||
// should retry (optionally after the time indicated in the Retry-After header).
|
|
||||||
//
|
|
||||||
// Applied only if Name is not specified.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#idempotency
|
|
||||||
// +optional
|
|
||||||
optional string generateName = 2;
|
|
||||||
|
|
||||||
// Namespace defines the space within each name must be unique. An empty namespace is
|
|
||||||
// equivalent to the "default" namespace, but "default" is the canonical representation.
|
|
||||||
// Not all objects are required to be scoped to a namespace - the value of this field for
|
|
||||||
// those objects will be empty.
|
|
||||||
//
|
|
||||||
// Must be a DNS_LABEL.
|
|
||||||
// Cannot be updated.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/namespaces
|
|
||||||
// +optional
|
|
||||||
optional string namespace = 3;
|
|
||||||
|
|
||||||
// SelfLink is a URL representing this object.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
optional string selfLink = 4;
|
|
||||||
|
|
||||||
// UID is the unique in time and space value for this object. It is typically generated by
|
|
||||||
// the server on successful creation of a resource and is not allowed to change on PUT
|
|
||||||
// operations.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
|
|
||||||
// +optional
|
|
||||||
optional string uid = 5;
|
|
||||||
|
|
||||||
// An opaque value that represents the internal version of this object that can
|
|
||||||
// be used by clients to determine when objects have changed. May be used for optimistic
|
|
||||||
// concurrency, change detection, and the watch operation on a resource or set of resources.
|
|
||||||
// Clients must treat these values as opaque and passed unmodified back to the server.
|
|
||||||
// They may only be valid for a particular resource or set of resources.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// Value must be treated as opaque by clients and .
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency
|
|
||||||
// +optional
|
|
||||||
optional string resourceVersion = 6;
|
|
||||||
|
|
||||||
// A sequence number representing a specific generation of the desired state.
|
|
||||||
// Populated by the system. Read-only.
|
|
||||||
// +optional
|
|
||||||
optional int64 generation = 7;
|
|
||||||
|
|
||||||
// CreationTimestamp is a timestamp representing the server time when this object was
|
|
||||||
// created. It is not guaranteed to be set in happens-before order across separate operations.
|
|
||||||
// Clients may not set this value. It is represented in RFC3339 form and is in UTC.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// Null for lists.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata
|
|
||||||
// +optional
|
|
||||||
optional Time creationTimestamp = 8;
|
|
||||||
|
|
||||||
// DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This
|
|
||||||
// field is set by the server when a graceful deletion is requested by the user, and is not
|
|
||||||
// directly settable by a client. The resource is expected to be deleted (no longer visible
|
|
||||||
// from resource lists, and not reachable by name) after the time in this field. Once set,
|
|
||||||
// this value may not be unset or be set further into the future, although it may be shortened
|
|
||||||
// or the resource may be deleted prior to this time. For example, a user may request that
|
|
||||||
// a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination
|
|
||||||
// signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard
|
|
||||||
// termination signal (SIGKILL) to the container and after cleanup, remove the pod from the
|
|
||||||
// API. In the presence of network partitions, this object may still exist after this
|
|
||||||
// timestamp, until an administrator or automated process can determine the resource is
|
|
||||||
// fully terminated.
|
|
||||||
// If not set, graceful deletion of the object has not been requested.
|
|
||||||
//
|
|
||||||
// Populated by the system when a graceful deletion is requested.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata
|
|
||||||
// +optional
|
|
||||||
optional Time deletionTimestamp = 9;
|
|
||||||
|
|
||||||
// Number of seconds allowed for this object to gracefully terminate before
|
|
||||||
// it will be removed from the system. Only set when deletionTimestamp is also set.
|
|
||||||
// May only be shortened.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
optional int64 deletionGracePeriodSeconds = 10;
|
|
||||||
|
|
||||||
// Map of string keys and values that can be used to organize and categorize
|
|
||||||
// (scope and select) objects. May match selectors of replication controllers
|
|
||||||
// and services.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/labels
|
|
||||||
// +optional
|
|
||||||
map<string, string> labels = 11;
|
|
||||||
|
|
||||||
// Annotations is an unstructured key value map stored with a resource that may be
|
|
||||||
// set by external tools to store and retrieve arbitrary metadata. They are not
|
|
||||||
// queryable and should be preserved when modifying objects.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/annotations
|
|
||||||
// +optional
|
|
||||||
map<string, string> annotations = 12;
|
|
||||||
|
|
||||||
// List of objects depended by this object. If ALL objects in the list have
|
|
||||||
// been deleted, this object will be garbage collected. If this object is managed by a controller,
|
|
||||||
// then an entry in this list will point to this controller, with the controller field set to true.
|
|
||||||
// There cannot be more than one managing controller.
|
|
||||||
// +optional
|
|
||||||
repeated OwnerReference ownerReferences = 13;
|
|
||||||
|
|
||||||
// Must be empty before the object is deleted from the registry. Each entry
|
|
||||||
// is an identifier for the responsible component that will remove the entry
|
|
||||||
// from the list. If the deletionTimestamp of the object is non-nil, entries
|
|
||||||
// in this list can only be removed.
|
|
||||||
// +optional
|
|
||||||
repeated string finalizers = 14;
|
|
||||||
|
|
||||||
// The name of the cluster which the object belongs to.
|
|
||||||
// This is used to distinguish resources with same name and namespace in different clusters.
|
|
||||||
// This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request.
|
|
||||||
// +optional
|
|
||||||
optional string clusterName = 15;
|
|
||||||
}
|
|
||||||
|
|
||||||
// OwnerReference contains enough information to let you identify an owning
|
|
||||||
// object. Currently, an owning object must be in the same namespace, so there
|
|
||||||
// is no namespace field.
|
|
||||||
message OwnerReference {
|
|
||||||
// API version of the referent.
|
|
||||||
optional string apiVersion = 5;
|
|
||||||
|
|
||||||
// Kind of the referent.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
optional string kind = 1;
|
|
||||||
|
|
||||||
// Name of the referent.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
|
|
||||||
optional string name = 3;
|
|
||||||
|
|
||||||
// UID of the referent.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
|
|
||||||
optional string uid = 4;
|
|
||||||
|
|
||||||
// If true, this reference points to the managing controller.
|
|
||||||
// +optional
|
|
||||||
optional bool controller = 6;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Preconditions must be fulfilled before an operation (update, delete, etc.) is carried out.
|
|
||||||
message Preconditions {
|
|
||||||
// Specifies the target UID.
|
|
||||||
// +optional
|
|
||||||
optional string uid = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// RootPaths lists the paths available at root.
|
|
||||||
// For example: "/healthz", "/apis".
|
|
||||||
message RootPaths {
|
|
||||||
// paths are the paths available at root.
|
|
||||||
repeated string paths = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// ServerAddressByClientCIDR helps the client to determine the server address that they should use, depending on the clientCIDR that they match.
|
|
||||||
message ServerAddressByClientCIDR {
|
|
||||||
// The CIDR with which clients can match their IP to figure out the server address that they should use.
|
|
||||||
optional string clientCIDR = 1;
|
|
||||||
|
|
||||||
// Address of this server, suitable for a client that matches the above CIDR.
|
|
||||||
// This can be a hostname, hostname:port, IP or IP:port.
|
|
||||||
optional string serverAddress = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Status is a return value for calls that don't return other objects.
|
|
||||||
message Status {
|
|
||||||
// Standard list metadata.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
optional ListMeta metadata = 1;
|
|
||||||
|
|
||||||
// Status of the operation.
|
|
||||||
// One of: "Success" or "Failure".
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status
|
|
||||||
// +optional
|
|
||||||
optional string status = 2;
|
|
||||||
|
|
||||||
// A human-readable description of the status of this operation.
|
|
||||||
// +optional
|
|
||||||
optional string message = 3;
|
|
||||||
|
|
||||||
// A machine-readable description of why this operation is in the
|
|
||||||
// "Failure" status. If this value is empty there
|
|
||||||
// is no information available. A Reason clarifies an HTTP status
|
|
||||||
// code but does not override it.
|
|
||||||
// +optional
|
|
||||||
optional string reason = 4;
|
|
||||||
|
|
||||||
// Extended data associated with the reason. Each reason may define its
|
|
||||||
// own extended details. This field is optional and the data returned
|
|
||||||
// is not guaranteed to conform to any schema except that defined by
|
|
||||||
// the reason type.
|
|
||||||
// +optional
|
|
||||||
optional StatusDetails details = 5;
|
|
||||||
|
|
||||||
// Suggested HTTP return code for this status, 0 if not set.
|
|
||||||
// +optional
|
|
||||||
optional int32 code = 6;
|
|
||||||
}
|
|
||||||
|
|
||||||
// StatusCause provides more information about an api.Status failure, including
|
|
||||||
// cases when multiple errors are encountered.
|
|
||||||
message StatusCause {
|
|
||||||
// A machine-readable description of the cause of the error. If this value is
|
|
||||||
// empty there is no information available.
|
|
||||||
// +optional
|
|
||||||
optional string reason = 1;
|
|
||||||
|
|
||||||
// A human-readable description of the cause of the error. This field may be
|
|
||||||
// presented as-is to a reader.
|
|
||||||
// +optional
|
|
||||||
optional string message = 2;
|
|
||||||
|
|
||||||
// The field of the resource that has caused this error, as named by its JSON
|
|
||||||
// serialization. May include dot and postfix notation for nested attributes.
|
|
||||||
// Arrays are zero-indexed. Fields may appear more than once in an array of
|
|
||||||
// causes due to fields having multiple errors.
|
|
||||||
// Optional.
|
|
||||||
//
|
|
||||||
// Examples:
|
|
||||||
// "name" - the field "name" on the current resource
|
|
||||||
// "items[0].name" - the field "name" on the first array entry in "items"
|
|
||||||
// +optional
|
|
||||||
optional string field = 3;
|
|
||||||
}
|
|
||||||
|
|
||||||
// StatusDetails is a set of additional properties that MAY be set by the
|
|
||||||
// server to provide additional information about a response. The Reason
|
|
||||||
// field of a Status object defines what attributes will be set. Clients
|
|
||||||
// must ignore fields that do not match the defined type of each attribute,
|
|
||||||
// and should assume that any attribute may be empty, invalid, or under
|
|
||||||
// defined.
|
|
||||||
message StatusDetails {
|
|
||||||
// The name attribute of the resource associated with the status StatusReason
|
|
||||||
// (when there is a single name which can be described).
|
|
||||||
// +optional
|
|
||||||
optional string name = 1;
|
|
||||||
|
|
||||||
// The group attribute of the resource associated with the status StatusReason.
|
|
||||||
// +optional
|
|
||||||
optional string group = 2;
|
|
||||||
|
|
||||||
// The kind attribute of the resource associated with the status StatusReason.
|
|
||||||
// On some operations may differ from the requested resource Kind.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
optional string kind = 3;
|
|
||||||
|
|
||||||
// The Causes array includes more details associated with the StatusReason
|
|
||||||
// failure. Not all StatusReasons may provide detailed causes.
|
|
||||||
// +optional
|
|
||||||
repeated StatusCause causes = 4;
|
|
||||||
|
|
||||||
// If specified, the time in seconds before the operation should be retried.
|
|
||||||
// +optional
|
|
||||||
optional int32 retryAfterSeconds = 5;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Time is a wrapper around time.Time which supports correct
|
|
||||||
// marshaling to YAML and JSON. Wrappers are provided for many
|
|
||||||
// of the factory methods that the time package offers.
|
|
||||||
//
|
|
||||||
// +protobuf.options.marshal=false
|
|
||||||
// +protobuf.as=Timestamp
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message Time {
|
|
||||||
// Represents seconds of UTC time since Unix epoch
|
|
||||||
// 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to
|
|
||||||
// 9999-12-31T23:59:59Z inclusive.
|
|
||||||
optional int64 seconds = 1;
|
|
||||||
|
|
||||||
// Non-negative fractions of a second at nanosecond resolution. Negative
|
|
||||||
// second values with fractions must still have non-negative nanos values
|
|
||||||
// that count forward in time. Must be from 0 to 999,999,999
|
|
||||||
// inclusive. This field may be limited in precision depending on context.
|
|
||||||
optional int32 nanos = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Timestamp is a struct that is equivalent to Time, but intended for
|
|
||||||
// protobuf marshalling/unmarshalling. It is generated into a serialization
|
|
||||||
// that matches Time. Do not use in Go structs.
|
|
||||||
message Timestamp {
|
|
||||||
// Represents seconds of UTC time since Unix epoch
|
|
||||||
// 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to
|
|
||||||
// 9999-12-31T23:59:59Z inclusive.
|
|
||||||
optional int64 seconds = 1;
|
|
||||||
|
|
||||||
// Non-negative fractions of a second at nanosecond resolution. Negative
|
|
||||||
// second values with fractions must still have non-negative nanos values
|
|
||||||
// that count forward in time. Must be from 0 to 999,999,999
|
|
||||||
// inclusive. This field may be limited in precision depending on context.
|
|
||||||
optional int32 nanos = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// TypeMeta describes an individual object in an API response or request
|
|
||||||
// with strings representing the type of the object and its API schema version.
|
|
||||||
// Structures that are versioned or persisted should inline TypeMeta.
|
|
||||||
message TypeMeta {
|
|
||||||
// Kind is a string value representing the REST resource this object represents.
|
|
||||||
// Servers may infer this from the endpoint the client submits requests to.
|
|
||||||
// Cannot be updated.
|
|
||||||
// In CamelCase.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
optional string kind = 1;
|
|
||||||
|
|
||||||
// APIVersion defines the versioned schema of this representation of an object.
|
|
||||||
// Servers should convert recognized schemas to the latest internal value, and
|
|
||||||
// may reject unrecognized values.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources
|
|
||||||
// +optional
|
|
||||||
optional string apiVersion = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verbs masks the value so protobuf can generate
|
|
||||||
//
|
|
||||||
// +protobuf.nullable=true
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
message Verbs {
|
|
||||||
// items, if empty, will result in an empty slice
|
|
||||||
|
|
||||||
repeated string items = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Event represents a single event to a watched resource.
|
|
||||||
//
|
|
||||||
// +protobuf=true
|
|
||||||
message WatchEvent {
|
|
||||||
optional string type = 1;
|
|
||||||
|
|
||||||
// Object is:
|
|
||||||
// * If Type is Added or Modified: the new state of the object.
|
|
||||||
// * If Type is Deleted: the state of the object immediately before deletion.
|
|
||||||
// * If Type is Error: *Status is recommended; other types may make sense
|
|
||||||
// depending on context.
|
|
||||||
optional k8s.io.apimachinery.pkg.runtime.RawExtension object = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
@@ -1,148 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"fmt"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// GroupResource specifies a Group and a Resource, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type GroupResource struct {
|
|
||||||
Group string `protobuf:"bytes,1,opt,name=group"`
|
|
||||||
Resource string `protobuf:"bytes,2,opt,name=resource"`
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gr *GroupResource) String() string {
|
|
||||||
if len(gr.Group) == 0 {
|
|
||||||
return gr.Resource
|
|
||||||
}
|
|
||||||
return gr.Resource + "." + gr.Group
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionResource unambiguously identifies a resource. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coersion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type GroupVersionResource struct {
|
|
||||||
Group string `protobuf:"bytes,1,opt,name=group"`
|
|
||||||
Version string `protobuf:"bytes,2,opt,name=version"`
|
|
||||||
Resource string `protobuf:"bytes,3,opt,name=resource"`
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvr *GroupVersionResource) String() string {
|
|
||||||
return strings.Join([]string{gvr.Group, "/", gvr.Version, ", Resource=", gvr.Resource}, "")
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupKind specifies a Group and a Kind, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type GroupKind struct {
|
|
||||||
Group string `protobuf:"bytes,1,opt,name=group"`
|
|
||||||
Kind string `protobuf:"bytes,2,opt,name=kind"`
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gk *GroupKind) String() string {
|
|
||||||
if len(gk.Group) == 0 {
|
|
||||||
return gk.Kind
|
|
||||||
}
|
|
||||||
return gk.Kind + "." + gk.Group
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionKind unambiguously identifies a kind. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coersion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type GroupVersionKind struct {
|
|
||||||
Group string `protobuf:"bytes,1,opt,name=group"`
|
|
||||||
Version string `protobuf:"bytes,2,opt,name=version"`
|
|
||||||
Kind string `protobuf:"bytes,3,opt,name=kind"`
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvk GroupVersionKind) String() string {
|
|
||||||
return gvk.Group + "/" + gvk.Version + ", Kind=" + gvk.Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersion contains the "group" and the "version", which uniquely identifies the API.
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type GroupVersion struct {
|
|
||||||
Group string `protobuf:"bytes,1,opt,name=group"`
|
|
||||||
Version string `protobuf:"bytes,2,opt,name=version"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Empty returns true if group and version are empty
|
|
||||||
func (gv GroupVersion) Empty() bool {
|
|
||||||
return len(gv.Group) == 0 && len(gv.Version) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
// String puts "group" and "version" into a single "group/version" string. For the legacy v1
|
|
||||||
// it returns "v1".
|
|
||||||
func (gv GroupVersion) String() string {
|
|
||||||
// special case the internal apiVersion for the legacy kube types
|
|
||||||
if gv.Empty() {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// special case of "v1" for backward compatibility
|
|
||||||
if len(gv.Group) == 0 && gv.Version == "v1" {
|
|
||||||
return gv.Version
|
|
||||||
}
|
|
||||||
if len(gv.Group) > 0 {
|
|
||||||
return gv.Group + "/" + gv.Version
|
|
||||||
}
|
|
||||||
return gv.Version
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON implements the json.Marshaller interface.
|
|
||||||
func (gv GroupVersion) MarshalJSON() ([]byte, error) {
|
|
||||||
s := gv.String()
|
|
||||||
if strings.Count(s, "/") > 1 {
|
|
||||||
return []byte{}, fmt.Errorf("illegal GroupVersion %v: contains more than one /", s)
|
|
||||||
}
|
|
||||||
return json.Marshal(s)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gv *GroupVersion) unmarshal(value []byte) error {
|
|
||||||
var s string
|
|
||||||
if err := json.Unmarshal(value, &s); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
parsed, err := schema.ParseGroupVersion(s)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
gv.Group, gv.Version = parsed.Group, parsed.Version
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON implements the json.Unmarshaller interface.
|
|
||||||
func (gv *GroupVersion) UnmarshalJSON(value []byte) error {
|
|
||||||
return gv.unmarshal(value)
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalTEXT implements the Ugorji's encoding.TextUnmarshaler interface.
|
|
||||||
func (gv *GroupVersion) UnmarshalText(value []byte) error {
|
|
||||||
return gv.unmarshal(value)
|
|
||||||
}
|
|
||||||
@@ -1,234 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/fields"
|
|
||||||
"k8s.io/apimachinery/pkg/labels"
|
|
||||||
"k8s.io/apimachinery/pkg/selection"
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
)
|
|
||||||
|
|
||||||
// LabelSelectorAsSelector converts the LabelSelector api type into a struct that implements
|
|
||||||
// labels.Selector
|
|
||||||
// Note: This function should be kept in sync with the selector methods in pkg/labels/selector.go
|
|
||||||
func LabelSelectorAsSelector(ps *LabelSelector) (labels.Selector, error) {
|
|
||||||
if ps == nil {
|
|
||||||
return labels.Nothing(), nil
|
|
||||||
}
|
|
||||||
if len(ps.MatchLabels)+len(ps.MatchExpressions) == 0 {
|
|
||||||
return labels.Everything(), nil
|
|
||||||
}
|
|
||||||
selector := labels.NewSelector()
|
|
||||||
for k, v := range ps.MatchLabels {
|
|
||||||
r, err := labels.NewRequirement(k, selection.Equals, []string{v})
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
selector = selector.Add(*r)
|
|
||||||
}
|
|
||||||
for _, expr := range ps.MatchExpressions {
|
|
||||||
var op selection.Operator
|
|
||||||
switch expr.Operator {
|
|
||||||
case LabelSelectorOpIn:
|
|
||||||
op = selection.In
|
|
||||||
case LabelSelectorOpNotIn:
|
|
||||||
op = selection.NotIn
|
|
||||||
case LabelSelectorOpExists:
|
|
||||||
op = selection.Exists
|
|
||||||
case LabelSelectorOpDoesNotExist:
|
|
||||||
op = selection.DoesNotExist
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("%q is not a valid pod selector operator", expr.Operator)
|
|
||||||
}
|
|
||||||
r, err := labels.NewRequirement(expr.Key, op, append([]string(nil), expr.Values...))
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
selector = selector.Add(*r)
|
|
||||||
}
|
|
||||||
return selector, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// LabelSelectorAsMap converts the LabelSelector api type into a map of strings, ie. the
|
|
||||||
// original structure of a label selector. Operators that cannot be converted into plain
|
|
||||||
// labels (Exists, DoesNotExist, NotIn, and In with more than one value) will result in
|
|
||||||
// an error.
|
|
||||||
func LabelSelectorAsMap(ps *LabelSelector) (map[string]string, error) {
|
|
||||||
if ps == nil {
|
|
||||||
return nil, nil
|
|
||||||
}
|
|
||||||
selector := map[string]string{}
|
|
||||||
for k, v := range ps.MatchLabels {
|
|
||||||
selector[k] = v
|
|
||||||
}
|
|
||||||
for _, expr := range ps.MatchExpressions {
|
|
||||||
switch expr.Operator {
|
|
||||||
case LabelSelectorOpIn:
|
|
||||||
if len(expr.Values) != 1 {
|
|
||||||
return selector, fmt.Errorf("operator %q without a single value cannot be converted into the old label selector format", expr.Operator)
|
|
||||||
}
|
|
||||||
// Should we do anything in case this will override a previous key-value pair?
|
|
||||||
selector[expr.Key] = expr.Values[0]
|
|
||||||
case LabelSelectorOpNotIn, LabelSelectorOpExists, LabelSelectorOpDoesNotExist:
|
|
||||||
return selector, fmt.Errorf("operator %q cannot be converted into the old label selector format", expr.Operator)
|
|
||||||
default:
|
|
||||||
return selector, fmt.Errorf("%q is not a valid selector operator", expr.Operator)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return selector, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseToLabelSelector parses a string representing a selector into a LabelSelector object.
|
|
||||||
// Note: This function should be kept in sync with the parser in pkg/labels/selector.go
|
|
||||||
func ParseToLabelSelector(selector string) (*LabelSelector, error) {
|
|
||||||
reqs, err := labels.ParseToRequirements(selector)
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("couldn't parse the selector string \"%s\": %v", selector, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
labelSelector := &LabelSelector{
|
|
||||||
MatchLabels: map[string]string{},
|
|
||||||
MatchExpressions: []LabelSelectorRequirement{},
|
|
||||||
}
|
|
||||||
for _, req := range reqs {
|
|
||||||
var op LabelSelectorOperator
|
|
||||||
switch req.Operator() {
|
|
||||||
case selection.Equals, selection.DoubleEquals:
|
|
||||||
vals := req.Values()
|
|
||||||
if vals.Len() != 1 {
|
|
||||||
return nil, fmt.Errorf("equals operator must have exactly one value")
|
|
||||||
}
|
|
||||||
val, ok := vals.PopAny()
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("equals operator has exactly one value but it cannot be retrieved")
|
|
||||||
}
|
|
||||||
labelSelector.MatchLabels[req.Key()] = val
|
|
||||||
continue
|
|
||||||
case selection.In:
|
|
||||||
op = LabelSelectorOpIn
|
|
||||||
case selection.NotIn:
|
|
||||||
op = LabelSelectorOpNotIn
|
|
||||||
case selection.Exists:
|
|
||||||
op = LabelSelectorOpExists
|
|
||||||
case selection.DoesNotExist:
|
|
||||||
op = LabelSelectorOpDoesNotExist
|
|
||||||
case selection.GreaterThan, selection.LessThan:
|
|
||||||
// Adding a separate case for these operators to indicate that this is deliberate
|
|
||||||
return nil, fmt.Errorf("%q isn't supported in label selectors", req.Operator())
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("%q is not a valid label selector operator", req.Operator())
|
|
||||||
}
|
|
||||||
labelSelector.MatchExpressions = append(labelSelector.MatchExpressions, LabelSelectorRequirement{
|
|
||||||
Key: req.Key(),
|
|
||||||
Operator: op,
|
|
||||||
Values: req.Values().List(),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
return labelSelector, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetAsLabelSelector converts the labels.Set object into a LabelSelector api object.
|
|
||||||
func SetAsLabelSelector(ls labels.Set) *LabelSelector {
|
|
||||||
if ls == nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
selector := &LabelSelector{
|
|
||||||
MatchLabels: make(map[string]string),
|
|
||||||
}
|
|
||||||
for label, value := range ls {
|
|
||||||
selector.MatchLabels[label] = value
|
|
||||||
}
|
|
||||||
|
|
||||||
return selector
|
|
||||||
}
|
|
||||||
|
|
||||||
// FormatLabelSelector convert labelSelector into plain string
|
|
||||||
func FormatLabelSelector(labelSelector *LabelSelector) string {
|
|
||||||
selector, err := LabelSelectorAsSelector(labelSelector)
|
|
||||||
if err != nil {
|
|
||||||
return "<error>"
|
|
||||||
}
|
|
||||||
|
|
||||||
l := selector.String()
|
|
||||||
if len(l) == 0 {
|
|
||||||
l = "<none>"
|
|
||||||
}
|
|
||||||
return l
|
|
||||||
}
|
|
||||||
|
|
||||||
func ExtractGroupVersions(l *APIGroupList) []string {
|
|
||||||
var groupVersions []string
|
|
||||||
for _, g := range l.Groups {
|
|
||||||
for _, gv := range g.Versions {
|
|
||||||
groupVersions = append(groupVersions, gv.GroupVersion)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return groupVersions
|
|
||||||
}
|
|
||||||
|
|
||||||
// HasAnnotation returns a bool if passed in annotation exists
|
|
||||||
func HasAnnotation(obj ObjectMeta, ann string) bool {
|
|
||||||
_, found := obj.Annotations[ann]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetMetaDataAnnotation sets the annotation and value
|
|
||||||
func SetMetaDataAnnotation(obj *ObjectMeta, ann string, value string) {
|
|
||||||
if obj.Annotations == nil {
|
|
||||||
obj.Annotations = make(map[string]string)
|
|
||||||
}
|
|
||||||
obj.Annotations[ann] = value
|
|
||||||
}
|
|
||||||
|
|
||||||
// SingleObject returns a ListOptions for watching a single object.
|
|
||||||
func SingleObject(meta ObjectMeta) ListOptions {
|
|
||||||
return ListOptions{
|
|
||||||
FieldSelector: fields.OneTermEqualSelector("metadata.name", meta.Name).String(),
|
|
||||||
ResourceVersion: meta.ResourceVersion,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewDeleteOptions returns a DeleteOptions indicating the resource should
|
|
||||||
// be deleted within the specified grace period. Use zero to indicate
|
|
||||||
// immediate deletion. If you would prefer to use the default grace period,
|
|
||||||
// use &metav1.DeleteOptions{} directly.
|
|
||||||
func NewDeleteOptions(grace int64) *DeleteOptions {
|
|
||||||
return &DeleteOptions{GracePeriodSeconds: &grace}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewPreconditionDeleteOptions returns a DeleteOptions with a UID precondition set.
|
|
||||||
func NewPreconditionDeleteOptions(uid string) *DeleteOptions {
|
|
||||||
u := types.UID(uid)
|
|
||||||
p := Preconditions{UID: &u}
|
|
||||||
return &DeleteOptions{Preconditions: &p}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewUIDPreconditions returns a Preconditions with UID set.
|
|
||||||
func NewUIDPreconditions(uid string) *Preconditions {
|
|
||||||
u := types.UID(uid)
|
|
||||||
return &Preconditions{UID: &u}
|
|
||||||
}
|
|
||||||
|
|
||||||
// HasObjectMetaSystemFieldValues returns true if fields that are managed by the system on ObjectMeta have values.
|
|
||||||
func HasObjectMetaSystemFieldValues(meta *ObjectMeta) bool {
|
|
||||||
return !meta.CreationTimestamp.Time.IsZero() ||
|
|
||||||
len(meta.UID) != 0
|
|
||||||
}
|
|
||||||
@@ -1,75 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 v1
|
|
||||||
|
|
||||||
// Clones the given selector and returns a new selector with the given key and value added.
|
|
||||||
// Returns the given selector, if labelKey is empty.
|
|
||||||
func CloneSelectorAndAddLabel(selector *LabelSelector, labelKey, labelValue string) *LabelSelector {
|
|
||||||
if labelKey == "" {
|
|
||||||
// Don't need to add a label.
|
|
||||||
return selector
|
|
||||||
}
|
|
||||||
|
|
||||||
// Clone.
|
|
||||||
newSelector := new(LabelSelector)
|
|
||||||
|
|
||||||
// TODO(madhusudancs): Check if you can use deepCopy_extensions_LabelSelector here.
|
|
||||||
newSelector.MatchLabels = make(map[string]string)
|
|
||||||
if selector.MatchLabels != nil {
|
|
||||||
for key, val := range selector.MatchLabels {
|
|
||||||
newSelector.MatchLabels[key] = val
|
|
||||||
}
|
|
||||||
}
|
|
||||||
newSelector.MatchLabels[labelKey] = labelValue
|
|
||||||
|
|
||||||
if selector.MatchExpressions != nil {
|
|
||||||
newMExps := make([]LabelSelectorRequirement, len(selector.MatchExpressions))
|
|
||||||
for i, me := range selector.MatchExpressions {
|
|
||||||
newMExps[i].Key = me.Key
|
|
||||||
newMExps[i].Operator = me.Operator
|
|
||||||
if me.Values != nil {
|
|
||||||
newMExps[i].Values = make([]string, len(me.Values))
|
|
||||||
copy(newMExps[i].Values, me.Values)
|
|
||||||
} else {
|
|
||||||
newMExps[i].Values = nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
newSelector.MatchExpressions = newMExps
|
|
||||||
} else {
|
|
||||||
newSelector.MatchExpressions = nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return newSelector
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddLabelToSelector returns a selector with the given key and value added to the given selector's MatchLabels.
|
|
||||||
func AddLabelToSelector(selector *LabelSelector, labelKey, labelValue string) *LabelSelector {
|
|
||||||
if labelKey == "" {
|
|
||||||
// Don't need to add a label.
|
|
||||||
return selector
|
|
||||||
}
|
|
||||||
if selector.MatchLabels == nil {
|
|
||||||
selector.MatchLabels = make(map[string]string)
|
|
||||||
}
|
|
||||||
selector.MatchLabels[labelKey] = labelValue
|
|
||||||
return selector
|
|
||||||
}
|
|
||||||
|
|
||||||
// SelectorHasLabel checks if the given selector contains the given label key in its MatchLabels
|
|
||||||
func SelectorHasLabel(selector *LabelSelector, labelKey string) bool {
|
|
||||||
return len(selector.MatchLabels[labelKey]) > 0
|
|
||||||
}
|
|
||||||
@@ -1,201 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
)
|
|
||||||
|
|
||||||
// ObjectMetaFor returns a pointer to a provided object's ObjectMeta.
|
|
||||||
// TODO: allow runtime.Unknown to extract this object
|
|
||||||
// TODO: Remove this function and use meta.ObjectMetaAccessor() instead.
|
|
||||||
func ObjectMetaFor(obj runtime.Object) (*ObjectMeta, error) {
|
|
||||||
v, err := conversion.EnforcePtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
var meta *ObjectMeta
|
|
||||||
err = runtime.FieldPtr(v, "ObjectMeta", &meta)
|
|
||||||
return meta, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListMetaFor returns a pointer to a provided object's ListMeta,
|
|
||||||
// or an error if the object does not have that pointer.
|
|
||||||
// TODO: allow runtime.Unknown to extract this object
|
|
||||||
// TODO: Remove this function and use meta.ObjectMetaAccessor() instead.
|
|
||||||
func ListMetaFor(obj runtime.Object) (*ListMeta, error) {
|
|
||||||
v, err := conversion.EnforcePtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
var meta *ListMeta
|
|
||||||
err = runtime.FieldPtr(v, "ListMeta", &meta)
|
|
||||||
return meta, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: move this, Object, List, and Type to a different package
|
|
||||||
type ObjectMetaAccessor interface {
|
|
||||||
GetObjectMeta() Object
|
|
||||||
}
|
|
||||||
|
|
||||||
// Object lets you work with object metadata from any of the versioned or
|
|
||||||
// internal API objects. Attempting to set or retrieve a field on an object that does
|
|
||||||
// not support that field (Name, UID, Namespace on lists) will be a no-op and return
|
|
||||||
// a default value.
|
|
||||||
type Object interface {
|
|
||||||
GetNamespace() string
|
|
||||||
SetNamespace(namespace string)
|
|
||||||
GetName() string
|
|
||||||
SetName(name string)
|
|
||||||
GetGenerateName() string
|
|
||||||
SetGenerateName(name string)
|
|
||||||
GetUID() types.UID
|
|
||||||
SetUID(uid types.UID)
|
|
||||||
GetResourceVersion() string
|
|
||||||
SetResourceVersion(version string)
|
|
||||||
GetSelfLink() string
|
|
||||||
SetSelfLink(selfLink string)
|
|
||||||
GetCreationTimestamp() Time
|
|
||||||
SetCreationTimestamp(timestamp Time)
|
|
||||||
GetDeletionTimestamp() *Time
|
|
||||||
SetDeletionTimestamp(timestamp *Time)
|
|
||||||
GetLabels() map[string]string
|
|
||||||
SetLabels(labels map[string]string)
|
|
||||||
GetAnnotations() map[string]string
|
|
||||||
SetAnnotations(annotations map[string]string)
|
|
||||||
GetFinalizers() []string
|
|
||||||
SetFinalizers(finalizers []string)
|
|
||||||
GetOwnerReferences() []OwnerReference
|
|
||||||
SetOwnerReferences([]OwnerReference)
|
|
||||||
GetClusterName() string
|
|
||||||
SetClusterName(clusterName string)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListMetaAccessor retrieves the list interface from an object
|
|
||||||
type ListMetaAccessor interface {
|
|
||||||
GetListMeta() List
|
|
||||||
}
|
|
||||||
|
|
||||||
// List lets you work with list metadata from any of the versioned or
|
|
||||||
// internal API objects. Attempting to set or retrieve a field on an object that does
|
|
||||||
// not support that field will be a no-op and return a default value.
|
|
||||||
// TODO: move this, and TypeMeta and ListMeta, to a different package
|
|
||||||
type List interface {
|
|
||||||
GetResourceVersion() string
|
|
||||||
SetResourceVersion(version string)
|
|
||||||
GetSelfLink() string
|
|
||||||
SetSelfLink(selfLink string)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Type exposes the type and APIVersion of versioned or internal API objects.
|
|
||||||
// TODO: move this, and TypeMeta and ListMeta, to a different package
|
|
||||||
type Type interface {
|
|
||||||
GetAPIVersion() string
|
|
||||||
SetAPIVersion(version string)
|
|
||||||
GetKind() string
|
|
||||||
SetKind(kind string)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (meta *ListMeta) GetResourceVersion() string { return meta.ResourceVersion }
|
|
||||||
func (meta *ListMeta) SetResourceVersion(version string) { meta.ResourceVersion = version }
|
|
||||||
func (meta *ListMeta) GetSelfLink() string { return meta.SelfLink }
|
|
||||||
func (meta *ListMeta) SetSelfLink(selfLink string) { meta.SelfLink = selfLink }
|
|
||||||
|
|
||||||
func (obj *TypeMeta) GetObjectKind() schema.ObjectKind { return obj }
|
|
||||||
|
|
||||||
// SetGroupVersionKind satisfies the ObjectKind interface for all objects that embed TypeMeta
|
|
||||||
func (obj *TypeMeta) SetGroupVersionKind(gvk schema.GroupVersionKind) {
|
|
||||||
obj.APIVersion, obj.Kind = gvk.ToAPIVersionAndKind()
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionKind satisfies the ObjectKind interface for all objects that embed TypeMeta
|
|
||||||
func (obj *TypeMeta) GroupVersionKind() schema.GroupVersionKind {
|
|
||||||
return schema.FromAPIVersionAndKind(obj.APIVersion, obj.Kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj *ListMeta) GetListMeta() List { return obj }
|
|
||||||
|
|
||||||
func (obj *ObjectMeta) GetObjectMeta() Object { return obj }
|
|
||||||
|
|
||||||
// Namespace implements metav1.Object for any object with an ObjectMeta typed field. Allows
|
|
||||||
// fast, direct access to metadata fields for API objects.
|
|
||||||
func (meta *ObjectMeta) GetNamespace() string { return meta.Namespace }
|
|
||||||
func (meta *ObjectMeta) SetNamespace(namespace string) { meta.Namespace = namespace }
|
|
||||||
func (meta *ObjectMeta) GetName() string { return meta.Name }
|
|
||||||
func (meta *ObjectMeta) SetName(name string) { meta.Name = name }
|
|
||||||
func (meta *ObjectMeta) GetGenerateName() string { return meta.GenerateName }
|
|
||||||
func (meta *ObjectMeta) SetGenerateName(generateName string) { meta.GenerateName = generateName }
|
|
||||||
func (meta *ObjectMeta) GetUID() types.UID { return meta.UID }
|
|
||||||
func (meta *ObjectMeta) SetUID(uid types.UID) { meta.UID = uid }
|
|
||||||
func (meta *ObjectMeta) GetResourceVersion() string { return meta.ResourceVersion }
|
|
||||||
func (meta *ObjectMeta) SetResourceVersion(version string) { meta.ResourceVersion = version }
|
|
||||||
func (meta *ObjectMeta) GetSelfLink() string { return meta.SelfLink }
|
|
||||||
func (meta *ObjectMeta) SetSelfLink(selfLink string) { meta.SelfLink = selfLink }
|
|
||||||
func (meta *ObjectMeta) GetCreationTimestamp() Time { return meta.CreationTimestamp }
|
|
||||||
func (meta *ObjectMeta) SetCreationTimestamp(creationTimestamp Time) {
|
|
||||||
meta.CreationTimestamp = creationTimestamp
|
|
||||||
}
|
|
||||||
func (meta *ObjectMeta) GetDeletionTimestamp() *Time { return meta.DeletionTimestamp }
|
|
||||||
func (meta *ObjectMeta) SetDeletionTimestamp(deletionTimestamp *Time) {
|
|
||||||
meta.DeletionTimestamp = deletionTimestamp
|
|
||||||
}
|
|
||||||
func (meta *ObjectMeta) GetLabels() map[string]string { return meta.Labels }
|
|
||||||
func (meta *ObjectMeta) SetLabels(labels map[string]string) { meta.Labels = labels }
|
|
||||||
func (meta *ObjectMeta) GetAnnotations() map[string]string { return meta.Annotations }
|
|
||||||
func (meta *ObjectMeta) SetAnnotations(annotations map[string]string) { meta.Annotations = annotations }
|
|
||||||
func (meta *ObjectMeta) GetFinalizers() []string { return meta.Finalizers }
|
|
||||||
func (meta *ObjectMeta) SetFinalizers(finalizers []string) { meta.Finalizers = finalizers }
|
|
||||||
|
|
||||||
func (meta *ObjectMeta) GetOwnerReferences() []OwnerReference {
|
|
||||||
ret := make([]OwnerReference, len(meta.OwnerReferences))
|
|
||||||
for i := 0; i < len(meta.OwnerReferences); i++ {
|
|
||||||
ret[i].Kind = meta.OwnerReferences[i].Kind
|
|
||||||
ret[i].Name = meta.OwnerReferences[i].Name
|
|
||||||
ret[i].UID = meta.OwnerReferences[i].UID
|
|
||||||
ret[i].APIVersion = meta.OwnerReferences[i].APIVersion
|
|
||||||
if meta.OwnerReferences[i].Controller != nil {
|
|
||||||
value := *meta.OwnerReferences[i].Controller
|
|
||||||
ret[i].Controller = &value
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
func (meta *ObjectMeta) SetOwnerReferences(references []OwnerReference) {
|
|
||||||
newReferences := make([]OwnerReference, len(references))
|
|
||||||
for i := 0; i < len(references); i++ {
|
|
||||||
newReferences[i].Kind = references[i].Kind
|
|
||||||
newReferences[i].Name = references[i].Name
|
|
||||||
newReferences[i].UID = references[i].UID
|
|
||||||
newReferences[i].APIVersion = references[i].APIVersion
|
|
||||||
if references[i].Controller != nil {
|
|
||||||
value := *references[i].Controller
|
|
||||||
newReferences[i].Controller = &value
|
|
||||||
}
|
|
||||||
}
|
|
||||||
meta.OwnerReferences = newReferences
|
|
||||||
}
|
|
||||||
|
|
||||||
func (meta *ObjectMeta) GetClusterName() string {
|
|
||||||
return meta.ClusterName
|
|
||||||
}
|
|
||||||
func (meta *ObjectMeta) SetClusterName(clusterName string) {
|
|
||||||
meta.ClusterName = clusterName
|
|
||||||
}
|
|
||||||
@@ -1,81 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// GroupName is the group name for this API.
|
|
||||||
const GroupName = "meta.k8s.io"
|
|
||||||
|
|
||||||
// SchemeGroupVersion is group version used to register these objects
|
|
||||||
var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: "v1"}
|
|
||||||
|
|
||||||
// WatchEventKind is name reserved for serializing watch events.
|
|
||||||
const WatchEventKind = "WatchEvent"
|
|
||||||
|
|
||||||
// Kind takes an unqualified kind and returns a Group qualified GroupKind
|
|
||||||
func Kind(kind string) schema.GroupKind {
|
|
||||||
return SchemeGroupVersion.WithKind(kind).GroupKind()
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddToGroupVersion registers common meta types into schemas.
|
|
||||||
func AddToGroupVersion(scheme *runtime.Scheme, groupVersion schema.GroupVersion) {
|
|
||||||
scheme.AddKnownTypeWithName(groupVersion.WithKind(WatchEventKind), &WatchEvent{})
|
|
||||||
scheme.AddKnownTypeWithName(
|
|
||||||
schema.GroupVersion{Group: groupVersion.Group, Version: runtime.APIVersionInternal}.WithKind(WatchEventKind),
|
|
||||||
&InternalEvent{},
|
|
||||||
)
|
|
||||||
// Supports legacy code paths, most callers should use metav1.ParameterCodec for now
|
|
||||||
scheme.AddKnownTypes(groupVersion,
|
|
||||||
&ListOptions{},
|
|
||||||
&ExportOptions{},
|
|
||||||
&GetOptions{},
|
|
||||||
&DeleteOptions{},
|
|
||||||
)
|
|
||||||
scheme.AddConversionFuncs(
|
|
||||||
Convert_versioned_Event_to_watch_Event,
|
|
||||||
Convert_versioned_InternalEvent_to_versioned_Event,
|
|
||||||
Convert_watch_Event_to_versioned_Event,
|
|
||||||
Convert_versioned_Event_to_versioned_InternalEvent,
|
|
||||||
)
|
|
||||||
|
|
||||||
// register manually. This usually goes through the SchemeBuilder, which we cannot use here.
|
|
||||||
scheme.AddGeneratedDeepCopyFuncs(GetGeneratedDeepCopyFuncs()...)
|
|
||||||
RegisterDefaults(scheme)
|
|
||||||
}
|
|
||||||
|
|
||||||
// scheme is the registry for the common types that adhere to the meta v1 API spec.
|
|
||||||
var scheme = runtime.NewScheme()
|
|
||||||
|
|
||||||
// ParameterCodec knows about query parameters used with the meta v1 API spec.
|
|
||||||
var ParameterCodec = runtime.NewParameterCodec(scheme)
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
scheme.AddUnversionedTypes(SchemeGroupVersion,
|
|
||||||
&ListOptions{},
|
|
||||||
&ExportOptions{},
|
|
||||||
&GetOptions{},
|
|
||||||
&DeleteOptions{},
|
|
||||||
)
|
|
||||||
|
|
||||||
// register manually. This usually goes through the SchemeBuilder, which we cannot use here.
|
|
||||||
scheme.AddGeneratedDeepCopyFuncs(GetGeneratedDeepCopyFuncs()...)
|
|
||||||
RegisterDefaults(scheme)
|
|
||||||
}
|
|
||||||
@@ -1,180 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/openapi"
|
|
||||||
|
|
||||||
"github.com/go-openapi/spec"
|
|
||||||
"github.com/google/gofuzz"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Time is a wrapper around time.Time which supports correct
|
|
||||||
// marshaling to YAML and JSON. Wrappers are provided for many
|
|
||||||
// of the factory methods that the time package offers.
|
|
||||||
//
|
|
||||||
// +protobuf.options.marshal=false
|
|
||||||
// +protobuf.as=Timestamp
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type Time struct {
|
|
||||||
time.Time `protobuf:"-"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// DeepCopy returns a deep-copy of the Time value. The underlying time.Time
|
|
||||||
// type is effectively immutable in the time API, so it is safe to
|
|
||||||
// copy-by-assign, despite the presence of (unexported) Pointer fields.
|
|
||||||
func (t Time) DeepCopy() Time {
|
|
||||||
return t
|
|
||||||
}
|
|
||||||
|
|
||||||
// String returns the representation of the time.
|
|
||||||
func (t Time) String() string {
|
|
||||||
return t.Time.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewTime returns a wrapped instance of the provided time
|
|
||||||
func NewTime(time time.Time) Time {
|
|
||||||
return Time{time}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Date returns the Time corresponding to the supplied parameters
|
|
||||||
// by wrapping time.Date.
|
|
||||||
func Date(year int, month time.Month, day, hour, min, sec, nsec int, loc *time.Location) Time {
|
|
||||||
return Time{time.Date(year, month, day, hour, min, sec, nsec, loc)}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Now returns the current local time.
|
|
||||||
func Now() Time {
|
|
||||||
return Time{time.Now()}
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsZero returns true if the value is nil or time is zero.
|
|
||||||
func (t *Time) IsZero() bool {
|
|
||||||
if t == nil {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
return t.Time.IsZero()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Before reports whether the time instant t is before u.
|
|
||||||
func (t Time) Before(u Time) bool {
|
|
||||||
return t.Time.Before(u.Time)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Equal reports whether the time instant t is equal to u.
|
|
||||||
func (t Time) Equal(u Time) bool {
|
|
||||||
return t.Time.Equal(u.Time)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unix returns the local time corresponding to the given Unix time
|
|
||||||
// by wrapping time.Unix.
|
|
||||||
func Unix(sec int64, nsec int64) Time {
|
|
||||||
return Time{time.Unix(sec, nsec)}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Rfc3339Copy returns a copy of the Time at second-level precision.
|
|
||||||
func (t Time) Rfc3339Copy() Time {
|
|
||||||
copied, _ := time.Parse(time.RFC3339, t.Format(time.RFC3339))
|
|
||||||
return Time{copied}
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON implements the json.Unmarshaller interface.
|
|
||||||
func (t *Time) UnmarshalJSON(b []byte) error {
|
|
||||||
if len(b) == 4 && string(b) == "null" {
|
|
||||||
t.Time = time.Time{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
var str string
|
|
||||||
json.Unmarshal(b, &str)
|
|
||||||
|
|
||||||
pt, err := time.Parse(time.RFC3339, str)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
t.Time = pt.Local()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalQueryParameter converts from a URL query parameter value to an object
|
|
||||||
func (t *Time) UnmarshalQueryParameter(str string) error {
|
|
||||||
if len(str) == 0 {
|
|
||||||
t.Time = time.Time{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
// Tolerate requests from older clients that used JSON serialization to build query params
|
|
||||||
if len(str) == 4 && str == "null" {
|
|
||||||
t.Time = time.Time{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
pt, err := time.Parse(time.RFC3339, str)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
t.Time = pt.Local()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON implements the json.Marshaler interface.
|
|
||||||
func (t Time) MarshalJSON() ([]byte, error) {
|
|
||||||
if t.IsZero() {
|
|
||||||
// Encode unset/nil objects as JSON's "null".
|
|
||||||
return []byte("null"), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return json.Marshal(t.UTC().Format(time.RFC3339))
|
|
||||||
}
|
|
||||||
|
|
||||||
func (_ Time) OpenAPIDefinition() openapi.OpenAPIDefinition {
|
|
||||||
return openapi.OpenAPIDefinition{
|
|
||||||
Schema: spec.Schema{
|
|
||||||
SchemaProps: spec.SchemaProps{
|
|
||||||
Type: []string{"string"},
|
|
||||||
Format: "date-time",
|
|
||||||
},
|
|
||||||
},
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalQueryParameter converts to a URL query parameter value
|
|
||||||
func (t Time) MarshalQueryParameter() (string, error) {
|
|
||||||
if t.IsZero() {
|
|
||||||
// Encode unset/nil objects as an empty string
|
|
||||||
return "", nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return t.UTC().Format(time.RFC3339), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Fuzz satisfies fuzz.Interface.
|
|
||||||
func (t *Time) Fuzz(c fuzz.Continue) {
|
|
||||||
if t == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// Allow for about 1000 years of randomness. Leave off nanoseconds
|
|
||||||
// because JSON doesn't represent them so they can't round-trip
|
|
||||||
// properly.
|
|
||||||
t.Time = time.Unix(c.Rand.Int63n(1000*365*24*60*60), 0)
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ fuzz.Interface = &Time{}
|
|
||||||
@@ -1,85 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Timestamp is a struct that is equivalent to Time, but intended for
|
|
||||||
// protobuf marshalling/unmarshalling. It is generated into a serialization
|
|
||||||
// that matches Time. Do not use in Go structs.
|
|
||||||
type Timestamp struct {
|
|
||||||
// Represents seconds of UTC time since Unix epoch
|
|
||||||
// 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to
|
|
||||||
// 9999-12-31T23:59:59Z inclusive.
|
|
||||||
Seconds int64 `json:"seconds" protobuf:"varint,1,opt,name=seconds"`
|
|
||||||
// Non-negative fractions of a second at nanosecond resolution. Negative
|
|
||||||
// second values with fractions must still have non-negative nanos values
|
|
||||||
// that count forward in time. Must be from 0 to 999,999,999
|
|
||||||
// inclusive. This field may be limited in precision depending on context.
|
|
||||||
Nanos int32 `json:"nanos" protobuf:"varint,2,opt,name=nanos"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Timestamp returns the Time as a new Timestamp value.
|
|
||||||
func (m *Time) ProtoTime() *Timestamp {
|
|
||||||
if m == nil {
|
|
||||||
return &Timestamp{}
|
|
||||||
}
|
|
||||||
return &Timestamp{
|
|
||||||
Seconds: m.Time.Unix(),
|
|
||||||
Nanos: int32(m.Time.Nanosecond()),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Size implements the protobuf marshalling interface.
|
|
||||||
func (m *Time) Size() (n int) {
|
|
||||||
if m == nil || m.Time.IsZero() {
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
return m.ProtoTime().Size()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Reset implements the protobuf marshalling interface.
|
|
||||||
func (m *Time) Unmarshal(data []byte) error {
|
|
||||||
if len(data) == 0 {
|
|
||||||
m.Time = time.Time{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
p := Timestamp{}
|
|
||||||
if err := p.Unmarshal(data); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
m.Time = time.Unix(p.Seconds, int64(p.Nanos)).Local()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Marshal implements the protobuf marshalling interface.
|
|
||||||
func (m *Time) Marshal() (data []byte, err error) {
|
|
||||||
if m == nil || m.Time.IsZero() {
|
|
||||||
return nil, nil
|
|
||||||
}
|
|
||||||
return m.ProtoTime().Marshal()
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalTo implements the protobuf marshalling interface.
|
|
||||||
func (m *Time) MarshalTo(data []byte) (int, error) {
|
|
||||||
if m == nil || m.Time.IsZero() {
|
|
||||||
return 0, nil
|
|
||||||
}
|
|
||||||
return m.ProtoTime().MarshalTo(data)
|
|
||||||
}
|
|
||||||
@@ -1,756 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 unversioned contains API types that are common to all versions.
|
|
||||||
//
|
|
||||||
// The package contains two categories of types:
|
|
||||||
// - external (serialized) types that lack their own version (e.g TypeMeta)
|
|
||||||
// - internal (never-serialized) types that are needed by several different
|
|
||||||
// api groups, and so live here, to avoid duplication and/or import loops
|
|
||||||
// (e.g. LabelSelector).
|
|
||||||
// In the future, we will probably move these categories of objects into
|
|
||||||
// separate packages.
|
|
||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TypeMeta describes an individual object in an API response or request
|
|
||||||
// with strings representing the type of the object and its API schema version.
|
|
||||||
// Structures that are versioned or persisted should inline TypeMeta.
|
|
||||||
type TypeMeta struct {
|
|
||||||
// Kind is a string value representing the REST resource this object represents.
|
|
||||||
// Servers may infer this from the endpoint the client submits requests to.
|
|
||||||
// Cannot be updated.
|
|
||||||
// In CamelCase.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
Kind string `json:"kind,omitempty" protobuf:"bytes,1,opt,name=kind"`
|
|
||||||
|
|
||||||
// APIVersion defines the versioned schema of this representation of an object.
|
|
||||||
// Servers should convert recognized schemas to the latest internal value, and
|
|
||||||
// may reject unrecognized values.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources
|
|
||||||
// +optional
|
|
||||||
APIVersion string `json:"apiVersion,omitempty" protobuf:"bytes,2,opt,name=apiVersion"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListMeta describes metadata that synthetic resources must have, including lists and
|
|
||||||
// various status objects. A resource may have only one of {ObjectMeta, ListMeta}.
|
|
||||||
type ListMeta struct {
|
|
||||||
// SelfLink is a URL representing this object.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
SelfLink string `json:"selfLink,omitempty" protobuf:"bytes,1,opt,name=selfLink"`
|
|
||||||
|
|
||||||
// String that identifies the server's internal version of this object that
|
|
||||||
// can be used by clients to determine when objects have changed.
|
|
||||||
// Value must be treated as opaque by clients and passed unmodified back to the server.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency
|
|
||||||
// +optional
|
|
||||||
ResourceVersion string `json:"resourceVersion,omitempty" protobuf:"bytes,2,opt,name=resourceVersion"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// These are internal finalizer values for Kubernetes-like APIs, must be qualified name unless defined here
|
|
||||||
const (
|
|
||||||
FinalizerOrphan string = "orphan"
|
|
||||||
)
|
|
||||||
|
|
||||||
// ObjectMeta is metadata that all persisted resources must have, which includes all objects
|
|
||||||
// users must create.
|
|
||||||
type ObjectMeta struct {
|
|
||||||
// Name must be unique within a namespace. Is required when creating resources, although
|
|
||||||
// some resources may allow a client to request the generation of an appropriate name
|
|
||||||
// automatically. Name is primarily intended for creation idempotence and configuration
|
|
||||||
// definition.
|
|
||||||
// Cannot be updated.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
|
|
||||||
// +optional
|
|
||||||
Name string `json:"name,omitempty" protobuf:"bytes,1,opt,name=name"`
|
|
||||||
|
|
||||||
// GenerateName is an optional prefix, used by the server, to generate a unique
|
|
||||||
// name ONLY IF the Name field has not been provided.
|
|
||||||
// If this field is used, the name returned to the client will be different
|
|
||||||
// than the name passed. This value will also be combined with a unique suffix.
|
|
||||||
// The provided value has the same validation rules as the Name field,
|
|
||||||
// and may be truncated by the length of the suffix required to make the value
|
|
||||||
// unique on the server.
|
|
||||||
//
|
|
||||||
// If this field is specified and the generated name exists, the server will
|
|
||||||
// NOT return a 409 - instead, it will either return 201 Created or 500 with Reason
|
|
||||||
// ServerTimeout indicating a unique name could not be found in the time allotted, and the client
|
|
||||||
// should retry (optionally after the time indicated in the Retry-After header).
|
|
||||||
//
|
|
||||||
// Applied only if Name is not specified.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#idempotency
|
|
||||||
// +optional
|
|
||||||
GenerateName string `json:"generateName,omitempty" protobuf:"bytes,2,opt,name=generateName"`
|
|
||||||
|
|
||||||
// Namespace defines the space within each name must be unique. An empty namespace is
|
|
||||||
// equivalent to the "default" namespace, but "default" is the canonical representation.
|
|
||||||
// Not all objects are required to be scoped to a namespace - the value of this field for
|
|
||||||
// those objects will be empty.
|
|
||||||
//
|
|
||||||
// Must be a DNS_LABEL.
|
|
||||||
// Cannot be updated.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/namespaces
|
|
||||||
// +optional
|
|
||||||
Namespace string `json:"namespace,omitempty" protobuf:"bytes,3,opt,name=namespace"`
|
|
||||||
|
|
||||||
// SelfLink is a URL representing this object.
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
SelfLink string `json:"selfLink,omitempty" protobuf:"bytes,4,opt,name=selfLink"`
|
|
||||||
|
|
||||||
// UID is the unique in time and space value for this object. It is typically generated by
|
|
||||||
// the server on successful creation of a resource and is not allowed to change on PUT
|
|
||||||
// operations.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
|
|
||||||
// +optional
|
|
||||||
UID types.UID `json:"uid,omitempty" protobuf:"bytes,5,opt,name=uid,casttype=k8s.io/kubernetes/pkg/types.UID"`
|
|
||||||
|
|
||||||
// An opaque value that represents the internal version of this object that can
|
|
||||||
// be used by clients to determine when objects have changed. May be used for optimistic
|
|
||||||
// concurrency, change detection, and the watch operation on a resource or set of resources.
|
|
||||||
// Clients must treat these values as opaque and passed unmodified back to the server.
|
|
||||||
// They may only be valid for a particular resource or set of resources.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// Value must be treated as opaque by clients and .
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency
|
|
||||||
// +optional
|
|
||||||
ResourceVersion string `json:"resourceVersion,omitempty" protobuf:"bytes,6,opt,name=resourceVersion"`
|
|
||||||
|
|
||||||
// A sequence number representing a specific generation of the desired state.
|
|
||||||
// Populated by the system. Read-only.
|
|
||||||
// +optional
|
|
||||||
Generation int64 `json:"generation,omitempty" protobuf:"varint,7,opt,name=generation"`
|
|
||||||
|
|
||||||
// CreationTimestamp is a timestamp representing the server time when this object was
|
|
||||||
// created. It is not guaranteed to be set in happens-before order across separate operations.
|
|
||||||
// Clients may not set this value. It is represented in RFC3339 form and is in UTC.
|
|
||||||
//
|
|
||||||
// Populated by the system.
|
|
||||||
// Read-only.
|
|
||||||
// Null for lists.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata
|
|
||||||
// +optional
|
|
||||||
CreationTimestamp Time `json:"creationTimestamp,omitempty" protobuf:"bytes,8,opt,name=creationTimestamp"`
|
|
||||||
|
|
||||||
// DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This
|
|
||||||
// field is set by the server when a graceful deletion is requested by the user, and is not
|
|
||||||
// directly settable by a client. The resource is expected to be deleted (no longer visible
|
|
||||||
// from resource lists, and not reachable by name) after the time in this field. Once set,
|
|
||||||
// this value may not be unset or be set further into the future, although it may be shortened
|
|
||||||
// or the resource may be deleted prior to this time. For example, a user may request that
|
|
||||||
// a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination
|
|
||||||
// signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard
|
|
||||||
// termination signal (SIGKILL) to the container and after cleanup, remove the pod from the
|
|
||||||
// API. In the presence of network partitions, this object may still exist after this
|
|
||||||
// timestamp, until an administrator or automated process can determine the resource is
|
|
||||||
// fully terminated.
|
|
||||||
// If not set, graceful deletion of the object has not been requested.
|
|
||||||
//
|
|
||||||
// Populated by the system when a graceful deletion is requested.
|
|
||||||
// Read-only.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata
|
|
||||||
// +optional
|
|
||||||
DeletionTimestamp *Time `json:"deletionTimestamp,omitempty" protobuf:"bytes,9,opt,name=deletionTimestamp"`
|
|
||||||
|
|
||||||
// Number of seconds allowed for this object to gracefully terminate before
|
|
||||||
// it will be removed from the system. Only set when deletionTimestamp is also set.
|
|
||||||
// May only be shortened.
|
|
||||||
// Read-only.
|
|
||||||
// +optional
|
|
||||||
DeletionGracePeriodSeconds *int64 `json:"deletionGracePeriodSeconds,omitempty" protobuf:"varint,10,opt,name=deletionGracePeriodSeconds"`
|
|
||||||
|
|
||||||
// Map of string keys and values that can be used to organize and categorize
|
|
||||||
// (scope and select) objects. May match selectors of replication controllers
|
|
||||||
// and services.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/labels
|
|
||||||
// +optional
|
|
||||||
Labels map[string]string `json:"labels,omitempty" protobuf:"bytes,11,rep,name=labels"`
|
|
||||||
|
|
||||||
// Annotations is an unstructured key value map stored with a resource that may be
|
|
||||||
// set by external tools to store and retrieve arbitrary metadata. They are not
|
|
||||||
// queryable and should be preserved when modifying objects.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/annotations
|
|
||||||
// +optional
|
|
||||||
Annotations map[string]string `json:"annotations,omitempty" protobuf:"bytes,12,rep,name=annotations"`
|
|
||||||
|
|
||||||
// List of objects depended by this object. If ALL objects in the list have
|
|
||||||
// been deleted, this object will be garbage collected. If this object is managed by a controller,
|
|
||||||
// then an entry in this list will point to this controller, with the controller field set to true.
|
|
||||||
// There cannot be more than one managing controller.
|
|
||||||
// +optional
|
|
||||||
OwnerReferences []OwnerReference `json:"ownerReferences,omitempty" patchStrategy:"merge" patchMergeKey:"uid" protobuf:"bytes,13,rep,name=ownerReferences"`
|
|
||||||
|
|
||||||
// Must be empty before the object is deleted from the registry. Each entry
|
|
||||||
// is an identifier for the responsible component that will remove the entry
|
|
||||||
// from the list. If the deletionTimestamp of the object is non-nil, entries
|
|
||||||
// in this list can only be removed.
|
|
||||||
// +optional
|
|
||||||
Finalizers []string `json:"finalizers,omitempty" patchStrategy:"merge" protobuf:"bytes,14,rep,name=finalizers"`
|
|
||||||
|
|
||||||
// The name of the cluster which the object belongs to.
|
|
||||||
// This is used to distinguish resources with same name and namespace in different clusters.
|
|
||||||
// This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request.
|
|
||||||
// +optional
|
|
||||||
ClusterName string `json:"clusterName,omitempty" protobuf:"bytes,15,opt,name=clusterName"`
|
|
||||||
}
|
|
||||||
|
|
||||||
const (
|
|
||||||
// NamespaceDefault means the object is in the default namespace which is applied when not specified by clients
|
|
||||||
NamespaceDefault string = "default"
|
|
||||||
// NamespaceAll is the default argument to specify on a context when you want to list or filter resources across all namespaces
|
|
||||||
NamespaceAll string = ""
|
|
||||||
// NamespaceNone is the argument for a context when there is no namespace.
|
|
||||||
NamespaceNone string = ""
|
|
||||||
// NamespaceSystem is the system namespace where we place system components.
|
|
||||||
NamespaceSystem string = "kube-system"
|
|
||||||
// NamespacePublic is the namespace where we place public info (ConfigMaps)
|
|
||||||
NamespacePublic string = "kube-public"
|
|
||||||
)
|
|
||||||
|
|
||||||
// OwnerReference contains enough information to let you identify an owning
|
|
||||||
// object. Currently, an owning object must be in the same namespace, so there
|
|
||||||
// is no namespace field.
|
|
||||||
type OwnerReference struct {
|
|
||||||
// API version of the referent.
|
|
||||||
APIVersion string `json:"apiVersion" protobuf:"bytes,5,opt,name=apiVersion"`
|
|
||||||
// Kind of the referent.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
Kind string `json:"kind" protobuf:"bytes,1,opt,name=kind"`
|
|
||||||
// Name of the referent.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#names
|
|
||||||
Name string `json:"name" protobuf:"bytes,3,opt,name=name"`
|
|
||||||
// UID of the referent.
|
|
||||||
// More info: http://kubernetes.io/docs/user-guide/identifiers#uids
|
|
||||||
UID types.UID `json:"uid" protobuf:"bytes,4,opt,name=uid,casttype=k8s.io/apimachinery/pkg/types.UID"`
|
|
||||||
// If true, this reference points to the managing controller.
|
|
||||||
// +optional
|
|
||||||
Controller *bool `json:"controller,omitempty" protobuf:"varint,6,opt,name=controller"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// ListOptions is the query options to a standard REST list call.
|
|
||||||
type ListOptions struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
|
|
||||||
// A selector to restrict the list of returned objects by their labels.
|
|
||||||
// Defaults to everything.
|
|
||||||
// +optional
|
|
||||||
LabelSelector string `json:"labelSelector,omitempty" protobuf:"bytes,1,opt,name=labelSelector"`
|
|
||||||
// A selector to restrict the list of returned objects by their fields.
|
|
||||||
// Defaults to everything.
|
|
||||||
// +optional
|
|
||||||
FieldSelector string `json:"fieldSelector,omitempty" protobuf:"bytes,2,opt,name=fieldSelector"`
|
|
||||||
// Watch for changes to the described resources and return them as a stream of
|
|
||||||
// add, update, and remove notifications. Specify resourceVersion.
|
|
||||||
// +optional
|
|
||||||
Watch bool `json:"watch,omitempty" protobuf:"varint,3,opt,name=watch"`
|
|
||||||
// When specified with a watch call, shows changes that occur after that particular version of a resource.
|
|
||||||
// Defaults to changes from the beginning of history.
|
|
||||||
// When specified for list:
|
|
||||||
// - if unset, then the result is returned from remote storage based on quorum-read flag;
|
|
||||||
// - if it's 0, then we simply return what we currently have in cache, no guarantee;
|
|
||||||
// - if set to non zero, then the result is at least as fresh as given rv.
|
|
||||||
// +optional
|
|
||||||
ResourceVersion string `json:"resourceVersion,omitempty" protobuf:"bytes,4,opt,name=resourceVersion"`
|
|
||||||
// Timeout for the list/watch call.
|
|
||||||
// +optional
|
|
||||||
TimeoutSeconds *int64 `json:"timeoutSeconds,omitempty" protobuf:"varint,5,opt,name=timeoutSeconds"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// ExportOptions is the query options to the standard REST get call.
|
|
||||||
type ExportOptions struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// Should this value be exported. Export strips fields that a user can not specify.
|
|
||||||
Export bool `json:"export" protobuf:"varint,1,opt,name=export"`
|
|
||||||
// Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'.
|
|
||||||
Exact bool `json:"exact" protobuf:"varint,2,opt,name=exact"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// GetOptions is the standard query options to the standard REST get call.
|
|
||||||
type GetOptions struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// When specified:
|
|
||||||
// - if unset, then the result is returned from remote storage based on quorum-read flag;
|
|
||||||
// - if it's 0, then we simply return what we currently have in cache, no guarantee;
|
|
||||||
// - if set to non zero, then the result is at least as fresh as given rv.
|
|
||||||
ResourceVersion string `json:"resourceVersion,omitempty" protobuf:"bytes,1,opt,name=resourceVersion"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// DeleteOptions may be provided when deleting an API object.
|
|
||||||
type DeleteOptions struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
|
|
||||||
// The duration in seconds before the object should be deleted. Value must be non-negative integer.
|
|
||||||
// The value zero indicates delete immediately. If this value is nil, the default grace period for the
|
|
||||||
// specified type will be used.
|
|
||||||
// Defaults to a per object value if not specified. zero means delete immediately.
|
|
||||||
// +optional
|
|
||||||
GracePeriodSeconds *int64 `json:"gracePeriodSeconds,omitempty" protobuf:"varint,1,opt,name=gracePeriodSeconds"`
|
|
||||||
|
|
||||||
// Must be fulfilled before a deletion is carried out. If not possible, a 409 Conflict status will be
|
|
||||||
// returned.
|
|
||||||
// +optional
|
|
||||||
Preconditions *Preconditions `json:"preconditions,omitempty" protobuf:"bytes,2,opt,name=preconditions"`
|
|
||||||
|
|
||||||
// Should the dependent objects be orphaned. If true/false, the "orphan"
|
|
||||||
// finalizer will be added to/removed from the object's finalizers list.
|
|
||||||
// +optional
|
|
||||||
OrphanDependents *bool `json:"orphanDependents,omitempty" protobuf:"varint,3,opt,name=orphanDependents"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Preconditions must be fulfilled before an operation (update, delete, etc.) is carried out.
|
|
||||||
type Preconditions struct {
|
|
||||||
// Specifies the target UID.
|
|
||||||
// +optional
|
|
||||||
UID *types.UID `json:"uid,omitempty" protobuf:"bytes,1,opt,name=uid,casttype=k8s.io/apimachinery/pkg/types.UID"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Status is a return value for calls that don't return other objects.
|
|
||||||
type Status struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// Standard list metadata.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
|
|
||||||
|
|
||||||
// Status of the operation.
|
|
||||||
// One of: "Success" or "Failure".
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status
|
|
||||||
// +optional
|
|
||||||
Status string `json:"status,omitempty" protobuf:"bytes,2,opt,name=status"`
|
|
||||||
// A human-readable description of the status of this operation.
|
|
||||||
// +optional
|
|
||||||
Message string `json:"message,omitempty" protobuf:"bytes,3,opt,name=message"`
|
|
||||||
// A machine-readable description of why this operation is in the
|
|
||||||
// "Failure" status. If this value is empty there
|
|
||||||
// is no information available. A Reason clarifies an HTTP status
|
|
||||||
// code but does not override it.
|
|
||||||
// +optional
|
|
||||||
Reason StatusReason `json:"reason,omitempty" protobuf:"bytes,4,opt,name=reason,casttype=StatusReason"`
|
|
||||||
// Extended data associated with the reason. Each reason may define its
|
|
||||||
// own extended details. This field is optional and the data returned
|
|
||||||
// is not guaranteed to conform to any schema except that defined by
|
|
||||||
// the reason type.
|
|
||||||
// +optional
|
|
||||||
Details *StatusDetails `json:"details,omitempty" protobuf:"bytes,5,opt,name=details"`
|
|
||||||
// Suggested HTTP return code for this status, 0 if not set.
|
|
||||||
// +optional
|
|
||||||
Code int32 `json:"code,omitempty" protobuf:"varint,6,opt,name=code"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// StatusDetails is a set of additional properties that MAY be set by the
|
|
||||||
// server to provide additional information about a response. The Reason
|
|
||||||
// field of a Status object defines what attributes will be set. Clients
|
|
||||||
// must ignore fields that do not match the defined type of each attribute,
|
|
||||||
// and should assume that any attribute may be empty, invalid, or under
|
|
||||||
// defined.
|
|
||||||
type StatusDetails struct {
|
|
||||||
// The name attribute of the resource associated with the status StatusReason
|
|
||||||
// (when there is a single name which can be described).
|
|
||||||
// +optional
|
|
||||||
Name string `json:"name,omitempty" protobuf:"bytes,1,opt,name=name"`
|
|
||||||
// The group attribute of the resource associated with the status StatusReason.
|
|
||||||
// +optional
|
|
||||||
Group string `json:"group,omitempty" protobuf:"bytes,2,opt,name=group"`
|
|
||||||
// The kind attribute of the resource associated with the status StatusReason.
|
|
||||||
// On some operations may differ from the requested resource Kind.
|
|
||||||
// More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds
|
|
||||||
// +optional
|
|
||||||
Kind string `json:"kind,omitempty" protobuf:"bytes,3,opt,name=kind"`
|
|
||||||
// The Causes array includes more details associated with the StatusReason
|
|
||||||
// failure. Not all StatusReasons may provide detailed causes.
|
|
||||||
// +optional
|
|
||||||
Causes []StatusCause `json:"causes,omitempty" protobuf:"bytes,4,rep,name=causes"`
|
|
||||||
// If specified, the time in seconds before the operation should be retried.
|
|
||||||
// +optional
|
|
||||||
RetryAfterSeconds int32 `json:"retryAfterSeconds,omitempty" protobuf:"varint,5,opt,name=retryAfterSeconds"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Values of Status.Status
|
|
||||||
const (
|
|
||||||
StatusSuccess = "Success"
|
|
||||||
StatusFailure = "Failure"
|
|
||||||
)
|
|
||||||
|
|
||||||
// StatusReason is an enumeration of possible failure causes. Each StatusReason
|
|
||||||
// must map to a single HTTP status code, but multiple reasons may map
|
|
||||||
// to the same HTTP status code.
|
|
||||||
// TODO: move to apiserver
|
|
||||||
type StatusReason string
|
|
||||||
|
|
||||||
const (
|
|
||||||
// StatusReasonUnknown means the server has declined to indicate a specific reason.
|
|
||||||
// The details field may contain other information about this error.
|
|
||||||
// Status code 500.
|
|
||||||
StatusReasonUnknown StatusReason = ""
|
|
||||||
|
|
||||||
// StatusReasonUnauthorized means the server can be reached and understood the request, but requires
|
|
||||||
// the user to present appropriate authorization credentials (identified by the WWW-Authenticate header)
|
|
||||||
// in order for the action to be completed. If the user has specified credentials on the request, the
|
|
||||||
// server considers them insufficient.
|
|
||||||
// Status code 401
|
|
||||||
StatusReasonUnauthorized StatusReason = "Unauthorized"
|
|
||||||
|
|
||||||
// StatusReasonForbidden means the server can be reached and understood the request, but refuses
|
|
||||||
// to take any further action. It is the result of the server being configured to deny access for some reason
|
|
||||||
// to the requested resource by the client.
|
|
||||||
// Details (optional):
|
|
||||||
// "kind" string - the kind attribute of the forbidden resource
|
|
||||||
// on some operations may differ from the requested
|
|
||||||
// resource.
|
|
||||||
// "id" string - the identifier of the forbidden resource
|
|
||||||
// Status code 403
|
|
||||||
StatusReasonForbidden StatusReason = "Forbidden"
|
|
||||||
|
|
||||||
// StatusReasonNotFound means one or more resources required for this operation
|
|
||||||
// could not be found.
|
|
||||||
// Details (optional):
|
|
||||||
// "kind" string - the kind attribute of the missing resource
|
|
||||||
// on some operations may differ from the requested
|
|
||||||
// resource.
|
|
||||||
// "id" string - the identifier of the missing resource
|
|
||||||
// Status code 404
|
|
||||||
StatusReasonNotFound StatusReason = "NotFound"
|
|
||||||
|
|
||||||
// StatusReasonAlreadyExists means the resource you are creating already exists.
|
|
||||||
// Details (optional):
|
|
||||||
// "kind" string - the kind attribute of the conflicting resource
|
|
||||||
// "id" string - the identifier of the conflicting resource
|
|
||||||
// Status code 409
|
|
||||||
StatusReasonAlreadyExists StatusReason = "AlreadyExists"
|
|
||||||
|
|
||||||
// StatusReasonConflict means the requested operation cannot be completed
|
|
||||||
// due to a conflict in the operation. The client may need to alter the
|
|
||||||
// request. Each resource may define custom details that indicate the
|
|
||||||
// nature of the conflict.
|
|
||||||
// Status code 409
|
|
||||||
StatusReasonConflict StatusReason = "Conflict"
|
|
||||||
|
|
||||||
// StatusReasonGone means the item is no longer available at the server and no
|
|
||||||
// forwarding address is known.
|
|
||||||
// Status code 410
|
|
||||||
StatusReasonGone StatusReason = "Gone"
|
|
||||||
|
|
||||||
// StatusReasonInvalid means the requested create or update operation cannot be
|
|
||||||
// completed due to invalid data provided as part of the request. The client may
|
|
||||||
// need to alter the request. When set, the client may use the StatusDetails
|
|
||||||
// message field as a summary of the issues encountered.
|
|
||||||
// Details (optional):
|
|
||||||
// "kind" string - the kind attribute of the invalid resource
|
|
||||||
// "id" string - the identifier of the invalid resource
|
|
||||||
// "causes" - one or more StatusCause entries indicating the data in the
|
|
||||||
// provided resource that was invalid. The code, message, and
|
|
||||||
// field attributes will be set.
|
|
||||||
// Status code 422
|
|
||||||
StatusReasonInvalid StatusReason = "Invalid"
|
|
||||||
|
|
||||||
// StatusReasonServerTimeout means the server can be reached and understood the request,
|
|
||||||
// but cannot complete the action in a reasonable time. The client should retry the request.
|
|
||||||
// This is may be due to temporary server load or a transient communication issue with
|
|
||||||
// another server. Status code 500 is used because the HTTP spec provides no suitable
|
|
||||||
// server-requested client retry and the 5xx class represents actionable errors.
|
|
||||||
// Details (optional):
|
|
||||||
// "kind" string - the kind attribute of the resource being acted on.
|
|
||||||
// "id" string - the operation that is being attempted.
|
|
||||||
// "retryAfterSeconds" int32 - the number of seconds before the operation should be retried
|
|
||||||
// Status code 500
|
|
||||||
StatusReasonServerTimeout StatusReason = "ServerTimeout"
|
|
||||||
|
|
||||||
// StatusReasonTimeout means that the request could not be completed within the given time.
|
|
||||||
// Clients can get this response only when they specified a timeout param in the request,
|
|
||||||
// or if the server cannot complete the operation within a reasonable amount of time.
|
|
||||||
// The request might succeed with an increased value of timeout param. The client *should*
|
|
||||||
// wait at least the number of seconds specified by the retryAfterSeconds field.
|
|
||||||
// Details (optional):
|
|
||||||
// "retryAfterSeconds" int32 - the number of seconds before the operation should be retried
|
|
||||||
// Status code 504
|
|
||||||
StatusReasonTimeout StatusReason = "Timeout"
|
|
||||||
|
|
||||||
// StatusReasonBadRequest means that the request itself was invalid, because the request
|
|
||||||
// doesn't make any sense, for example deleting a read-only object. This is different than
|
|
||||||
// StatusReasonInvalid above which indicates that the API call could possibly succeed, but the
|
|
||||||
// data was invalid. API calls that return BadRequest can never succeed.
|
|
||||||
StatusReasonBadRequest StatusReason = "BadRequest"
|
|
||||||
|
|
||||||
// StatusReasonMethodNotAllowed means that the action the client attempted to perform on the
|
|
||||||
// resource was not supported by the code - for instance, attempting to delete a resource that
|
|
||||||
// can only be created. API calls that return MethodNotAllowed can never succeed.
|
|
||||||
StatusReasonMethodNotAllowed StatusReason = "MethodNotAllowed"
|
|
||||||
|
|
||||||
// StatusReasonInternalError indicates that an internal error occurred, it is unexpected
|
|
||||||
// and the outcome of the call is unknown.
|
|
||||||
// Details (optional):
|
|
||||||
// "causes" - The original error
|
|
||||||
// Status code 500
|
|
||||||
StatusReasonInternalError StatusReason = "InternalError"
|
|
||||||
|
|
||||||
// StatusReasonExpired indicates that the request is invalid because the content you are requesting
|
|
||||||
// has expired and is no longer available. It is typically associated with watches that can't be
|
|
||||||
// serviced.
|
|
||||||
// Status code 410 (gone)
|
|
||||||
StatusReasonExpired StatusReason = "Expired"
|
|
||||||
|
|
||||||
// StatusReasonServiceUnavailable means that the request itself was valid,
|
|
||||||
// but the requested service is unavailable at this time.
|
|
||||||
// Retrying the request after some time might succeed.
|
|
||||||
// Status code 503
|
|
||||||
StatusReasonServiceUnavailable StatusReason = "ServiceUnavailable"
|
|
||||||
)
|
|
||||||
|
|
||||||
// StatusCause provides more information about an api.Status failure, including
|
|
||||||
// cases when multiple errors are encountered.
|
|
||||||
type StatusCause struct {
|
|
||||||
// A machine-readable description of the cause of the error. If this value is
|
|
||||||
// empty there is no information available.
|
|
||||||
// +optional
|
|
||||||
Type CauseType `json:"reason,omitempty" protobuf:"bytes,1,opt,name=reason,casttype=CauseType"`
|
|
||||||
// A human-readable description of the cause of the error. This field may be
|
|
||||||
// presented as-is to a reader.
|
|
||||||
// +optional
|
|
||||||
Message string `json:"message,omitempty" protobuf:"bytes,2,opt,name=message"`
|
|
||||||
// The field of the resource that has caused this error, as named by its JSON
|
|
||||||
// serialization. May include dot and postfix notation for nested attributes.
|
|
||||||
// Arrays are zero-indexed. Fields may appear more than once in an array of
|
|
||||||
// causes due to fields having multiple errors.
|
|
||||||
// Optional.
|
|
||||||
//
|
|
||||||
// Examples:
|
|
||||||
// "name" - the field "name" on the current resource
|
|
||||||
// "items[0].name" - the field "name" on the first array entry in "items"
|
|
||||||
// +optional
|
|
||||||
Field string `json:"field,omitempty" protobuf:"bytes,3,opt,name=field"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// CauseType is a machine readable value providing more detail about what
|
|
||||||
// occurred in a status response. An operation may have multiple causes for a
|
|
||||||
// status (whether Failure or Success).
|
|
||||||
type CauseType string
|
|
||||||
|
|
||||||
const (
|
|
||||||
// CauseTypeFieldValueNotFound is used to report failure to find a requested value
|
|
||||||
// (e.g. looking up an ID).
|
|
||||||
CauseTypeFieldValueNotFound CauseType = "FieldValueNotFound"
|
|
||||||
// CauseTypeFieldValueRequired is used to report required values that are not
|
|
||||||
// provided (e.g. empty strings, null values, or empty arrays).
|
|
||||||
CauseTypeFieldValueRequired CauseType = "FieldValueRequired"
|
|
||||||
// CauseTypeFieldValueDuplicate is used to report collisions of values that must be
|
|
||||||
// unique (e.g. unique IDs).
|
|
||||||
CauseTypeFieldValueDuplicate CauseType = "FieldValueDuplicate"
|
|
||||||
// CauseTypeFieldValueInvalid is used to report malformed values (e.g. failed regex
|
|
||||||
// match).
|
|
||||||
CauseTypeFieldValueInvalid CauseType = "FieldValueInvalid"
|
|
||||||
// CauseTypeFieldValueNotSupported is used to report valid (as per formatting rules)
|
|
||||||
// values that can not be handled (e.g. an enumerated string).
|
|
||||||
CauseTypeFieldValueNotSupported CauseType = "FieldValueNotSupported"
|
|
||||||
// CauseTypeUnexpectedServerResponse is used to report when the server responded to the client
|
|
||||||
// without the expected return type. The presence of this cause indicates the error may be
|
|
||||||
// due to an intervening proxy or the server software malfunctioning.
|
|
||||||
CauseTypeUnexpectedServerResponse CauseType = "UnexpectedServerResponse"
|
|
||||||
)
|
|
||||||
|
|
||||||
// APIVersions lists the versions that are available, to allow clients to
|
|
||||||
// discover the API at /api, which is the root path of the legacy v1 API.
|
|
||||||
//
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type APIVersions struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// versions are the api versions that are available.
|
|
||||||
Versions []string `json:"versions" protobuf:"bytes,1,rep,name=versions"`
|
|
||||||
// a map of client CIDR to server address that is serving this group.
|
|
||||||
// This is to help clients reach servers in the most network-efficient way possible.
|
|
||||||
// Clients can use the appropriate server address as per the CIDR that they match.
|
|
||||||
// In case of multiple matches, clients should use the longest matching CIDR.
|
|
||||||
// The server returns only those CIDRs that it thinks that the client can match.
|
|
||||||
// For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP.
|
|
||||||
// Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
|
|
||||||
ServerAddressByClientCIDRs []ServerAddressByClientCIDR `json:"serverAddressByClientCIDRs" protobuf:"bytes,2,rep,name=serverAddressByClientCIDRs"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIGroupList is a list of APIGroup, to allow clients to discover the API at
|
|
||||||
// /apis.
|
|
||||||
type APIGroupList struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// groups is a list of APIGroup.
|
|
||||||
Groups []APIGroup `json:"groups" protobuf:"bytes,1,rep,name=groups"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIGroup contains the name, the supported versions, and the preferred version
|
|
||||||
// of a group.
|
|
||||||
type APIGroup struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// name is the name of the group.
|
|
||||||
Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
|
|
||||||
// versions are the versions supported in this group.
|
|
||||||
Versions []GroupVersionForDiscovery `json:"versions" protobuf:"bytes,2,rep,name=versions"`
|
|
||||||
// preferredVersion is the version preferred by the API server, which
|
|
||||||
// probably is the storage version.
|
|
||||||
// +optional
|
|
||||||
PreferredVersion GroupVersionForDiscovery `json:"preferredVersion,omitempty" protobuf:"bytes,3,opt,name=preferredVersion"`
|
|
||||||
// a map of client CIDR to server address that is serving this group.
|
|
||||||
// This is to help clients reach servers in the most network-efficient way possible.
|
|
||||||
// Clients can use the appropriate server address as per the CIDR that they match.
|
|
||||||
// In case of multiple matches, clients should use the longest matching CIDR.
|
|
||||||
// The server returns only those CIDRs that it thinks that the client can match.
|
|
||||||
// For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP.
|
|
||||||
// Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.
|
|
||||||
ServerAddressByClientCIDRs []ServerAddressByClientCIDR `json:"serverAddressByClientCIDRs" protobuf:"bytes,4,rep,name=serverAddressByClientCIDRs"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// ServerAddressByClientCIDR helps the client to determine the server address that they should use, depending on the clientCIDR that they match.
|
|
||||||
type ServerAddressByClientCIDR struct {
|
|
||||||
// The CIDR with which clients can match their IP to figure out the server address that they should use.
|
|
||||||
ClientCIDR string `json:"clientCIDR" protobuf:"bytes,1,opt,name=clientCIDR"`
|
|
||||||
// Address of this server, suitable for a client that matches the above CIDR.
|
|
||||||
// This can be a hostname, hostname:port, IP or IP:port.
|
|
||||||
ServerAddress string `json:"serverAddress" protobuf:"bytes,2,opt,name=serverAddress"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersion contains the "group/version" and "version" string of a version.
|
|
||||||
// It is made a struct to keep extensibility.
|
|
||||||
type GroupVersionForDiscovery struct {
|
|
||||||
// groupVersion specifies the API group and version in the form "group/version"
|
|
||||||
GroupVersion string `json:"groupVersion" protobuf:"bytes,1,opt,name=groupVersion"`
|
|
||||||
// version specifies the version in the form of "version". This is to save
|
|
||||||
// the clients the trouble of splitting the GroupVersion.
|
|
||||||
Version string `json:"version" protobuf:"bytes,2,opt,name=version"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIResource specifies the name of a resource and whether it is namespaced.
|
|
||||||
type APIResource struct {
|
|
||||||
// name is the name of the resource.
|
|
||||||
Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
|
|
||||||
// namespaced indicates if a resource is namespaced or not.
|
|
||||||
Namespaced bool `json:"namespaced" protobuf:"varint,2,opt,name=namespaced"`
|
|
||||||
// kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')
|
|
||||||
Kind string `json:"kind" protobuf:"bytes,3,opt,name=kind"`
|
|
||||||
// verbs is a list of supported kube verbs (this includes get, list, watch, create,
|
|
||||||
// update, patch, delete, deletecollection, and proxy)
|
|
||||||
Verbs Verbs `json:"verbs" protobuf:"bytes,4,opt,name=verbs"`
|
|
||||||
// shortNames is a list of suggested short names of the resource.
|
|
||||||
ShortNames []string `json:"shortNames,omitempty" protobuf:"bytes,5,rep,name=shortNames"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verbs masks the value so protobuf can generate
|
|
||||||
//
|
|
||||||
// +protobuf.nullable=true
|
|
||||||
// +protobuf.options.(gogoproto.goproto_stringer)=false
|
|
||||||
type Verbs []string
|
|
||||||
|
|
||||||
func (vs Verbs) String() string {
|
|
||||||
return fmt.Sprintf("%v", []string(vs))
|
|
||||||
}
|
|
||||||
|
|
||||||
// APIResourceList is a list of APIResource, it is used to expose the name of the
|
|
||||||
// resources supported in a specific group and version, and if the resource
|
|
||||||
// is namespaced.
|
|
||||||
type APIResourceList struct {
|
|
||||||
TypeMeta `json:",inline"`
|
|
||||||
// groupVersion is the group and version this APIResourceList is for.
|
|
||||||
GroupVersion string `json:"groupVersion" protobuf:"bytes,1,opt,name=groupVersion"`
|
|
||||||
// resources contains the name of the resources and if they are namespaced.
|
|
||||||
APIResources []APIResource `json:"resources" protobuf:"bytes,2,rep,name=resources"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// RootPaths lists the paths available at root.
|
|
||||||
// For example: "/healthz", "/apis".
|
|
||||||
type RootPaths struct {
|
|
||||||
// paths are the paths available at root.
|
|
||||||
Paths []string `json:"paths" protobuf:"bytes,1,rep,name=paths"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: remove me when watch is refactored
|
|
||||||
func LabelSelectorQueryParam(version string) string {
|
|
||||||
return "labelSelector"
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: remove me when watch is refactored
|
|
||||||
func FieldSelectorQueryParam(version string) string {
|
|
||||||
return "fieldSelector"
|
|
||||||
}
|
|
||||||
|
|
||||||
// String returns available api versions as a human-friendly version string.
|
|
||||||
func (apiVersions APIVersions) String() string {
|
|
||||||
return strings.Join(apiVersions.Versions, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (apiVersions APIVersions) GoString() string {
|
|
||||||
return apiVersions.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Patch is provided to give a concrete name and type to the Kubernetes PATCH request body.
|
|
||||||
type Patch struct{}
|
|
||||||
|
|
||||||
// Note:
|
|
||||||
// There are two different styles of label selectors used in versioned types:
|
|
||||||
// an older style which is represented as just a string in versioned types, and a
|
|
||||||
// newer style that is structured. LabelSelector is an internal representation for the
|
|
||||||
// latter style.
|
|
||||||
|
|
||||||
// A label selector is a label query over a set of resources. The result of matchLabels and
|
|
||||||
// matchExpressions are ANDed. An empty label selector matches all objects. A null
|
|
||||||
// label selector matches no objects.
|
|
||||||
type LabelSelector struct {
|
|
||||||
// matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
|
|
||||||
// map is equivalent to an element of matchExpressions, whose key field is "key", the
|
|
||||||
// operator is "In", and the values array contains only "value". The requirements are ANDed.
|
|
||||||
// +optional
|
|
||||||
MatchLabels map[string]string `json:"matchLabels,omitempty" protobuf:"bytes,1,rep,name=matchLabels"`
|
|
||||||
// matchExpressions is a list of label selector requirements. The requirements are ANDed.
|
|
||||||
// +optional
|
|
||||||
MatchExpressions []LabelSelectorRequirement `json:"matchExpressions,omitempty" protobuf:"bytes,2,rep,name=matchExpressions"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// A label selector requirement is a selector that contains values, a key, and an operator that
|
|
||||||
// relates the key and values.
|
|
||||||
type LabelSelectorRequirement struct {
|
|
||||||
// key is the label key that the selector applies to.
|
|
||||||
Key string `json:"key" patchStrategy:"merge" patchMergeKey:"key" protobuf:"bytes,1,opt,name=key"`
|
|
||||||
// operator represents a key's relationship to a set of values.
|
|
||||||
// Valid operators ard In, NotIn, Exists and DoesNotExist.
|
|
||||||
Operator LabelSelectorOperator `json:"operator" protobuf:"bytes,2,opt,name=operator,casttype=LabelSelectorOperator"`
|
|
||||||
// values is an array of string values. If the operator is In or NotIn,
|
|
||||||
// the values array must be non-empty. If the operator is Exists or DoesNotExist,
|
|
||||||
// the values array must be empty. This array is replaced during a strategic
|
|
||||||
// merge patch.
|
|
||||||
// +optional
|
|
||||||
Values []string `json:"values,omitempty" protobuf:"bytes,3,rep,name=values"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// A label selector operator is the set of operators that can be used in a selector requirement.
|
|
||||||
type LabelSelectorOperator string
|
|
||||||
|
|
||||||
const (
|
|
||||||
LabelSelectorOpIn LabelSelectorOperator = "In"
|
|
||||||
LabelSelectorOpNotIn LabelSelectorOperator = "NotIn"
|
|
||||||
LabelSelectorOpExists LabelSelectorOperator = "Exists"
|
|
||||||
LabelSelectorOpDoesNotExist LabelSelectorOperator = "DoesNotExist"
|
|
||||||
)
|
|
||||||
@@ -1,288 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 v1
|
|
||||||
|
|
||||||
// This file contains a collection of methods that can be used from go-restful to
|
|
||||||
// generate Swagger API documentation for its models. Please read this PR for more
|
|
||||||
// information on the implementation: https://github.com/emicklei/go-restful/pull/215
|
|
||||||
//
|
|
||||||
// TODOs are ignored from the parser (e.g. TODO(andronat):... || TODO:...) if and only if
|
|
||||||
// they are on one line! For multiple line or blocks that you want to ignore use ---.
|
|
||||||
// Any context after a --- is ignored.
|
|
||||||
//
|
|
||||||
// Those methods can be generated by using hack/update-generated-swagger-docs.sh
|
|
||||||
|
|
||||||
// AUTO-GENERATED FUNCTIONS START HERE
|
|
||||||
var map_APIGroup = map[string]string{
|
|
||||||
"": "APIGroup contains the name, the supported versions, and the preferred version of a group.",
|
|
||||||
"name": "name is the name of the group.",
|
|
||||||
"versions": "versions are the versions supported in this group.",
|
|
||||||
"preferredVersion": "preferredVersion is the version preferred by the API server, which probably is the storage version.",
|
|
||||||
"serverAddressByClientCIDRs": "a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (APIGroup) SwaggerDoc() map[string]string {
|
|
||||||
return map_APIGroup
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_APIGroupList = map[string]string{
|
|
||||||
"": "APIGroupList is a list of APIGroup, to allow clients to discover the API at /apis.",
|
|
||||||
"groups": "groups is a list of APIGroup.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (APIGroupList) SwaggerDoc() map[string]string {
|
|
||||||
return map_APIGroupList
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_APIResource = map[string]string{
|
|
||||||
"": "APIResource specifies the name of a resource and whether it is namespaced.",
|
|
||||||
"name": "name is the name of the resource.",
|
|
||||||
"namespaced": "namespaced indicates if a resource is namespaced or not.",
|
|
||||||
"kind": "kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')",
|
|
||||||
"verbs": "verbs is a list of supported kube verbs (this includes get, list, watch, create, update, patch, delete, deletecollection, and proxy)",
|
|
||||||
"shortNames": "shortNames is a list of suggested short names of the resource.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (APIResource) SwaggerDoc() map[string]string {
|
|
||||||
return map_APIResource
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_APIResourceList = map[string]string{
|
|
||||||
"": "APIResourceList is a list of APIResource, it is used to expose the name of the resources supported in a specific group and version, and if the resource is namespaced.",
|
|
||||||
"groupVersion": "groupVersion is the group and version this APIResourceList is for.",
|
|
||||||
"resources": "resources contains the name of the resources and if they are namespaced.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (APIResourceList) SwaggerDoc() map[string]string {
|
|
||||||
return map_APIResourceList
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_APIVersions = map[string]string{
|
|
||||||
"": "APIVersions lists the versions that are available, to allow clients to discover the API at /api, which is the root path of the legacy v1 API.",
|
|
||||||
"versions": "versions are the api versions that are available.",
|
|
||||||
"serverAddressByClientCIDRs": "a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (APIVersions) SwaggerDoc() map[string]string {
|
|
||||||
return map_APIVersions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_DeleteOptions = map[string]string{
|
|
||||||
"": "DeleteOptions may be provided when deleting an API object.",
|
|
||||||
"gracePeriodSeconds": "The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.",
|
|
||||||
"preconditions": "Must be fulfilled before a deletion is carried out. If not possible, a 409 Conflict status will be returned.",
|
|
||||||
"orphanDependents": "Should the dependent objects be orphaned. If true/false, the \"orphan\" finalizer will be added to/removed from the object's finalizers list.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (DeleteOptions) SwaggerDoc() map[string]string {
|
|
||||||
return map_DeleteOptions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_ExportOptions = map[string]string{
|
|
||||||
"": "ExportOptions is the query options to the standard REST get call.",
|
|
||||||
"export": "Should this value be exported. Export strips fields that a user can not specify.",
|
|
||||||
"exact": "Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ExportOptions) SwaggerDoc() map[string]string {
|
|
||||||
return map_ExportOptions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_GetOptions = map[string]string{
|
|
||||||
"": "GetOptions is the standard query options to the standard REST get call.",
|
|
||||||
"resourceVersion": "When specified: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it's 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (GetOptions) SwaggerDoc() map[string]string {
|
|
||||||
return map_GetOptions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_GroupVersionForDiscovery = map[string]string{
|
|
||||||
"": "GroupVersion contains the \"group/version\" and \"version\" string of a version. It is made a struct to keep extensibility.",
|
|
||||||
"groupVersion": "groupVersion specifies the API group and version in the form \"group/version\"",
|
|
||||||
"version": "version specifies the version in the form of \"version\". This is to save the clients the trouble of splitting the GroupVersion.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (GroupVersionForDiscovery) SwaggerDoc() map[string]string {
|
|
||||||
return map_GroupVersionForDiscovery
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_LabelSelector = map[string]string{
|
|
||||||
"": "A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.",
|
|
||||||
"matchLabels": "matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is \"key\", the operator is \"In\", and the values array contains only \"value\". The requirements are ANDed.",
|
|
||||||
"matchExpressions": "matchExpressions is a list of label selector requirements. The requirements are ANDed.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (LabelSelector) SwaggerDoc() map[string]string {
|
|
||||||
return map_LabelSelector
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_LabelSelectorRequirement = map[string]string{
|
|
||||||
"": "A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.",
|
|
||||||
"key": "key is the label key that the selector applies to.",
|
|
||||||
"operator": "operator represents a key's relationship to a set of values. Valid operators ard In, NotIn, Exists and DoesNotExist.",
|
|
||||||
"values": "values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (LabelSelectorRequirement) SwaggerDoc() map[string]string {
|
|
||||||
return map_LabelSelectorRequirement
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_ListMeta = map[string]string{
|
|
||||||
"": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
|
|
||||||
"selfLink": "SelfLink is a URL representing this object. Populated by the system. Read-only.",
|
|
||||||
"resourceVersion": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ListMeta) SwaggerDoc() map[string]string {
|
|
||||||
return map_ListMeta
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_ListOptions = map[string]string{
|
|
||||||
"": "ListOptions is the query options to a standard REST list call.",
|
|
||||||
"labelSelector": "A selector to restrict the list of returned objects by their labels. Defaults to everything.",
|
|
||||||
"fieldSelector": "A selector to restrict the list of returned objects by their fields. Defaults to everything.",
|
|
||||||
"watch": "Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.",
|
|
||||||
"resourceVersion": "When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it's 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.",
|
|
||||||
"timeoutSeconds": "Timeout for the list/watch call.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ListOptions) SwaggerDoc() map[string]string {
|
|
||||||
return map_ListOptions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_ObjectMeta = map[string]string{
|
|
||||||
"": "ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.",
|
|
||||||
"name": "Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names",
|
|
||||||
"generateName": "GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).\n\nApplied only if Name is not specified. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#idempotency",
|
|
||||||
"namespace": "Namespace defines the space within each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces",
|
|
||||||
"selfLink": "SelfLink is a URL representing this object. Populated by the system. Read-only.",
|
|
||||||
"uid": "UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids",
|
|
||||||
"resourceVersion": "An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency",
|
|
||||||
"generation": "A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
|
|
||||||
"creationTimestamp": "CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC.\n\nPopulated by the system. Read-only. Null for lists. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata",
|
|
||||||
"deletionTimestamp": "DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field. Once set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time. For example, a user may request that a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to the container and after cleanup, remove the pod from the API. In the presence of network partitions, this object may still exist after this timestamp, until an administrator or automated process can determine the resource is fully terminated. If not set, graceful deletion of the object has not been requested.\n\nPopulated by the system when a graceful deletion is requested. Read-only. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata",
|
|
||||||
"deletionGracePeriodSeconds": "Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
|
|
||||||
"labels": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels",
|
|
||||||
"annotations": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations",
|
|
||||||
"ownerReferences": "List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.",
|
|
||||||
"finalizers": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed.",
|
|
||||||
"clusterName": "The name of the cluster which the object belongs to. This is used to distinguish resources with same name and namespace in different clusters. This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ObjectMeta) SwaggerDoc() map[string]string {
|
|
||||||
return map_ObjectMeta
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_OwnerReference = map[string]string{
|
|
||||||
"": "OwnerReference contains enough information to let you identify an owning object. Currently, an owning object must be in the same namespace, so there is no namespace field.",
|
|
||||||
"apiVersion": "API version of the referent.",
|
|
||||||
"kind": "Kind of the referent. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds",
|
|
||||||
"name": "Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names",
|
|
||||||
"uid": "UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids",
|
|
||||||
"controller": "If true, this reference points to the managing controller.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (OwnerReference) SwaggerDoc() map[string]string {
|
|
||||||
return map_OwnerReference
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_Patch = map[string]string{
|
|
||||||
"": "Patch is provided to give a concrete name and type to the Kubernetes PATCH request body.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (Patch) SwaggerDoc() map[string]string {
|
|
||||||
return map_Patch
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_Preconditions = map[string]string{
|
|
||||||
"": "Preconditions must be fulfilled before an operation (update, delete, etc.) is carried out.",
|
|
||||||
"uid": "Specifies the target UID.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (Preconditions) SwaggerDoc() map[string]string {
|
|
||||||
return map_Preconditions
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_RootPaths = map[string]string{
|
|
||||||
"": "RootPaths lists the paths available at root. For example: \"/healthz\", \"/apis\".",
|
|
||||||
"paths": "paths are the paths available at root.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (RootPaths) SwaggerDoc() map[string]string {
|
|
||||||
return map_RootPaths
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_ServerAddressByClientCIDR = map[string]string{
|
|
||||||
"": "ServerAddressByClientCIDR helps the client to determine the server address that they should use, depending on the clientCIDR that they match.",
|
|
||||||
"clientCIDR": "The CIDR with which clients can match their IP to figure out the server address that they should use.",
|
|
||||||
"serverAddress": "Address of this server, suitable for a client that matches the above CIDR. This can be a hostname, hostname:port, IP or IP:port.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ServerAddressByClientCIDR) SwaggerDoc() map[string]string {
|
|
||||||
return map_ServerAddressByClientCIDR
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_Status = map[string]string{
|
|
||||||
"": "Status is a return value for calls that don't return other objects.",
|
|
||||||
"metadata": "Standard list metadata. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds",
|
|
||||||
"status": "Status of the operation. One of: \"Success\" or \"Failure\". More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status",
|
|
||||||
"message": "A human-readable description of the status of this operation.",
|
|
||||||
"reason": "A machine-readable description of why this operation is in the \"Failure\" status. If this value is empty there is no information available. A Reason clarifies an HTTP status code but does not override it.",
|
|
||||||
"details": "Extended data associated with the reason. Each reason may define its own extended details. This field is optional and the data returned is not guaranteed to conform to any schema except that defined by the reason type.",
|
|
||||||
"code": "Suggested HTTP return code for this status, 0 if not set.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (Status) SwaggerDoc() map[string]string {
|
|
||||||
return map_Status
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_StatusCause = map[string]string{
|
|
||||||
"": "StatusCause provides more information about an api.Status failure, including cases when multiple errors are encountered.",
|
|
||||||
"reason": "A machine-readable description of the cause of the error. If this value is empty there is no information available.",
|
|
||||||
"message": "A human-readable description of the cause of the error. This field may be presented as-is to a reader.",
|
|
||||||
"field": "The field of the resource that has caused this error, as named by its JSON serialization. May include dot and postfix notation for nested attributes. Arrays are zero-indexed. Fields may appear more than once in an array of causes due to fields having multiple errors. Optional.\n\nExamples:\n \"name\" - the field \"name\" on the current resource\n \"items[0].name\" - the field \"name\" on the first array entry in \"items\"",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (StatusCause) SwaggerDoc() map[string]string {
|
|
||||||
return map_StatusCause
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_StatusDetails = map[string]string{
|
|
||||||
"": "StatusDetails is a set of additional properties that MAY be set by the server to provide additional information about a response. The Reason field of a Status object defines what attributes will be set. Clients must ignore fields that do not match the defined type of each attribute, and should assume that any attribute may be empty, invalid, or under defined.",
|
|
||||||
"name": "The name attribute of the resource associated with the status StatusReason (when there is a single name which can be described).",
|
|
||||||
"group": "The group attribute of the resource associated with the status StatusReason.",
|
|
||||||
"kind": "The kind attribute of the resource associated with the status StatusReason. On some operations may differ from the requested resource Kind. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds",
|
|
||||||
"causes": "The Causes array includes more details associated with the StatusReason failure. Not all StatusReasons may provide detailed causes.",
|
|
||||||
"retryAfterSeconds": "If specified, the time in seconds before the operation should be retried.",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (StatusDetails) SwaggerDoc() map[string]string {
|
|
||||||
return map_StatusDetails
|
|
||||||
}
|
|
||||||
|
|
||||||
var map_TypeMeta = map[string]string{
|
|
||||||
"": "TypeMeta describes an individual object in an API response or request with strings representing the type of the object and its API schema version. Structures that are versioned or persisted should inline TypeMeta.",
|
|
||||||
"kind": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds",
|
|
||||||
"apiVersion": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources",
|
|
||||||
}
|
|
||||||
|
|
||||||
func (TypeMeta) SwaggerDoc() map[string]string {
|
|
||||||
return map_TypeMeta
|
|
||||||
}
|
|
||||||
|
|
||||||
// AUTO-GENERATED FUNCTIONS END HERE
|
|
||||||
@@ -1,660 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 unstructured
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
gojson "encoding/json"
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/golang/glog"
|
|
||||||
|
|
||||||
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/types"
|
|
||||||
"k8s.io/apimachinery/pkg/util/json"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Unstructured allows objects that do not have Golang structs registered to be manipulated
|
|
||||||
// generically. This can be used to deal with the API objects from a plug-in. Unstructured
|
|
||||||
// objects still have functioning TypeMeta features-- kind, version, etc.
|
|
||||||
//
|
|
||||||
// WARNING: This object has accessors for the v1 standard metadata. You *MUST NOT* use this
|
|
||||||
// type if you are dealing with objects that are not in the server meta v1 schema.
|
|
||||||
//
|
|
||||||
// TODO: make the serialization part of this type distinct from the field accessors.
|
|
||||||
type Unstructured struct {
|
|
||||||
// Object is a JSON compatible map with string, float, int, bool, []interface{}, or
|
|
||||||
// map[string]interface{}
|
|
||||||
// children.
|
|
||||||
Object map[string]interface{}
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ metav1.Object = &Unstructured{}
|
|
||||||
var _ runtime.Unstructured = &Unstructured{}
|
|
||||||
var _ runtime.Unstructured = &UnstructuredList{}
|
|
||||||
|
|
||||||
func (obj *Unstructured) GetObjectKind() schema.ObjectKind { return obj }
|
|
||||||
func (obj *UnstructuredList) GetObjectKind() schema.ObjectKind { return obj }
|
|
||||||
|
|
||||||
func (obj *Unstructured) IsUnstructuredObject() {}
|
|
||||||
func (obj *UnstructuredList) IsUnstructuredObject() {}
|
|
||||||
|
|
||||||
func (obj *Unstructured) IsList() bool {
|
|
||||||
if obj.Object != nil {
|
|
||||||
_, ok := obj.Object["items"]
|
|
||||||
return ok
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
func (obj *UnstructuredList) IsList() bool { return true }
|
|
||||||
|
|
||||||
func (obj *Unstructured) UnstructuredContent() map[string]interface{} {
|
|
||||||
if obj.Object == nil {
|
|
||||||
obj.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
return obj.Object
|
|
||||||
}
|
|
||||||
func (obj *UnstructuredList) UnstructuredContent() map[string]interface{} {
|
|
||||||
if obj.Object == nil {
|
|
||||||
obj.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
return obj.Object
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON ensures that the unstructured object produces proper
|
|
||||||
// JSON when passed to Go's standard JSON library.
|
|
||||||
func (u *Unstructured) MarshalJSON() ([]byte, error) {
|
|
||||||
var buf bytes.Buffer
|
|
||||||
err := UnstructuredJSONScheme.Encode(u, &buf)
|
|
||||||
return buf.Bytes(), err
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON ensures that the unstructured object properly decodes
|
|
||||||
// JSON when passed to Go's standard JSON library.
|
|
||||||
func (u *Unstructured) UnmarshalJSON(b []byte) error {
|
|
||||||
_, _, err := UnstructuredJSONScheme.Decode(b, nil, u)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
func getNestedField(obj map[string]interface{}, fields ...string) interface{} {
|
|
||||||
var val interface{} = obj
|
|
||||||
for _, field := range fields {
|
|
||||||
if _, ok := val.(map[string]interface{}); !ok {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
val = val.(map[string]interface{})[field]
|
|
||||||
}
|
|
||||||
return val
|
|
||||||
}
|
|
||||||
|
|
||||||
func getNestedString(obj map[string]interface{}, fields ...string) string {
|
|
||||||
if str, ok := getNestedField(obj, fields...).(string); ok {
|
|
||||||
return str
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
func getNestedSlice(obj map[string]interface{}, fields ...string) []string {
|
|
||||||
if m, ok := getNestedField(obj, fields...).([]interface{}); ok {
|
|
||||||
strSlice := make([]string, 0, len(m))
|
|
||||||
for _, v := range m {
|
|
||||||
if str, ok := v.(string); ok {
|
|
||||||
strSlice = append(strSlice, str)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return strSlice
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func getNestedMap(obj map[string]interface{}, fields ...string) map[string]string {
|
|
||||||
if m, ok := getNestedField(obj, fields...).(map[string]interface{}); ok {
|
|
||||||
strMap := make(map[string]string, len(m))
|
|
||||||
for k, v := range m {
|
|
||||||
if str, ok := v.(string); ok {
|
|
||||||
strMap[k] = str
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return strMap
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func setNestedField(obj map[string]interface{}, value interface{}, fields ...string) {
|
|
||||||
m := obj
|
|
||||||
if len(fields) > 1 {
|
|
||||||
for _, field := range fields[0 : len(fields)-1] {
|
|
||||||
if _, ok := m[field].(map[string]interface{}); !ok {
|
|
||||||
m[field] = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
m = m[field].(map[string]interface{})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
m[fields[len(fields)-1]] = value
|
|
||||||
}
|
|
||||||
|
|
||||||
func setNestedSlice(obj map[string]interface{}, value []string, fields ...string) {
|
|
||||||
m := make([]interface{}, 0, len(value))
|
|
||||||
for _, v := range value {
|
|
||||||
m = append(m, v)
|
|
||||||
}
|
|
||||||
setNestedField(obj, m, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func setNestedMap(obj map[string]interface{}, value map[string]string, fields ...string) {
|
|
||||||
m := make(map[string]interface{}, len(value))
|
|
||||||
for k, v := range value {
|
|
||||||
m[k] = v
|
|
||||||
}
|
|
||||||
setNestedField(obj, m, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) setNestedField(value interface{}, fields ...string) {
|
|
||||||
if u.Object == nil {
|
|
||||||
u.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
setNestedField(u.Object, value, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) setNestedSlice(value []string, fields ...string) {
|
|
||||||
if u.Object == nil {
|
|
||||||
u.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
setNestedSlice(u.Object, value, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) setNestedMap(value map[string]string, fields ...string) {
|
|
||||||
if u.Object == nil {
|
|
||||||
u.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
setNestedMap(u.Object, value, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func extractOwnerReference(src interface{}) metav1.OwnerReference {
|
|
||||||
v := src.(map[string]interface{})
|
|
||||||
controllerPtr, ok := (getNestedField(v, "controller")).(*bool)
|
|
||||||
if !ok {
|
|
||||||
controllerPtr = nil
|
|
||||||
} else {
|
|
||||||
if controllerPtr != nil {
|
|
||||||
controller := *controllerPtr
|
|
||||||
controllerPtr = &controller
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return metav1.OwnerReference{
|
|
||||||
Kind: getNestedString(v, "kind"),
|
|
||||||
Name: getNestedString(v, "name"),
|
|
||||||
APIVersion: getNestedString(v, "apiVersion"),
|
|
||||||
UID: (types.UID)(getNestedString(v, "uid")),
|
|
||||||
Controller: controllerPtr,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func setOwnerReference(src metav1.OwnerReference) map[string]interface{} {
|
|
||||||
ret := make(map[string]interface{})
|
|
||||||
controllerPtr := src.Controller
|
|
||||||
if controllerPtr != nil {
|
|
||||||
controller := *controllerPtr
|
|
||||||
controllerPtr = &controller
|
|
||||||
}
|
|
||||||
setNestedField(ret, src.Kind, "kind")
|
|
||||||
setNestedField(ret, src.Name, "name")
|
|
||||||
setNestedField(ret, src.APIVersion, "apiVersion")
|
|
||||||
setNestedField(ret, string(src.UID), "uid")
|
|
||||||
setNestedField(ret, controllerPtr, "controller")
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
func getOwnerReferences(object map[string]interface{}) ([]map[string]interface{}, error) {
|
|
||||||
field := getNestedField(object, "metadata", "ownerReferences")
|
|
||||||
if field == nil {
|
|
||||||
return nil, fmt.Errorf("cannot find field metadata.ownerReferences in %v", object)
|
|
||||||
}
|
|
||||||
ownerReferences, ok := field.([]map[string]interface{})
|
|
||||||
if ok {
|
|
||||||
return ownerReferences, nil
|
|
||||||
}
|
|
||||||
// TODO: This is hacky...
|
|
||||||
interfaces, ok := field.([]interface{})
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("expect metadata.ownerReferences to be a slice in %#v", object)
|
|
||||||
}
|
|
||||||
ownerReferences = make([]map[string]interface{}, 0, len(interfaces))
|
|
||||||
for i := 0; i < len(interfaces); i++ {
|
|
||||||
r, ok := interfaces[i].(map[string]interface{})
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("expect element metadata.ownerReferences to be a map[string]interface{} in %#v", object)
|
|
||||||
}
|
|
||||||
ownerReferences = append(ownerReferences, r)
|
|
||||||
}
|
|
||||||
return ownerReferences, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetOwnerReferences() []metav1.OwnerReference {
|
|
||||||
original, err := getOwnerReferences(u.Object)
|
|
||||||
if err != nil {
|
|
||||||
glog.V(6).Info(err)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
ret := make([]metav1.OwnerReference, 0, len(original))
|
|
||||||
for i := 0; i < len(original); i++ {
|
|
||||||
ret = append(ret, extractOwnerReference(original[i]))
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetOwnerReferences(references []metav1.OwnerReference) {
|
|
||||||
var newReferences = make([]map[string]interface{}, 0, len(references))
|
|
||||||
for i := 0; i < len(references); i++ {
|
|
||||||
newReferences = append(newReferences, setOwnerReference(references[i]))
|
|
||||||
}
|
|
||||||
u.setNestedField(newReferences, "metadata", "ownerReferences")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetAPIVersion() string {
|
|
||||||
return getNestedString(u.Object, "apiVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetAPIVersion(version string) {
|
|
||||||
u.setNestedField(version, "apiVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetKind() string {
|
|
||||||
return getNestedString(u.Object, "kind")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetKind(kind string) {
|
|
||||||
u.setNestedField(kind, "kind")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetNamespace() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "namespace")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetNamespace(namespace string) {
|
|
||||||
u.setNestedField(namespace, "metadata", "namespace")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetName() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "name")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetName(name string) {
|
|
||||||
u.setNestedField(name, "metadata", "name")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetGenerateName() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "generateName")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetGenerateName(name string) {
|
|
||||||
u.setNestedField(name, "metadata", "generateName")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetUID() types.UID {
|
|
||||||
return types.UID(getNestedString(u.Object, "metadata", "uid"))
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetUID(uid types.UID) {
|
|
||||||
u.setNestedField(string(uid), "metadata", "uid")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetResourceVersion() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "resourceVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetResourceVersion(version string) {
|
|
||||||
u.setNestedField(version, "metadata", "resourceVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetSelfLink() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "selfLink")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetSelfLink(selfLink string) {
|
|
||||||
u.setNestedField(selfLink, "metadata", "selfLink")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetCreationTimestamp() metav1.Time {
|
|
||||||
var timestamp metav1.Time
|
|
||||||
timestamp.UnmarshalQueryParameter(getNestedString(u.Object, "metadata", "creationTimestamp"))
|
|
||||||
return timestamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetCreationTimestamp(timestamp metav1.Time) {
|
|
||||||
ts, _ := timestamp.MarshalQueryParameter()
|
|
||||||
u.setNestedField(ts, "metadata", "creationTimestamp")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetDeletionTimestamp() *metav1.Time {
|
|
||||||
var timestamp metav1.Time
|
|
||||||
timestamp.UnmarshalQueryParameter(getNestedString(u.Object, "metadata", "deletionTimestamp"))
|
|
||||||
if timestamp.IsZero() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return ×tamp
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetDeletionTimestamp(timestamp *metav1.Time) {
|
|
||||||
ts, _ := timestamp.MarshalQueryParameter()
|
|
||||||
u.setNestedField(ts, "metadata", "deletionTimestamp")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetLabels() map[string]string {
|
|
||||||
return getNestedMap(u.Object, "metadata", "labels")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetLabels(labels map[string]string) {
|
|
||||||
u.setNestedMap(labels, "metadata", "labels")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetAnnotations() map[string]string {
|
|
||||||
return getNestedMap(u.Object, "metadata", "annotations")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetAnnotations(annotations map[string]string) {
|
|
||||||
u.setNestedMap(annotations, "metadata", "annotations")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetGroupVersionKind(gvk schema.GroupVersionKind) {
|
|
||||||
u.SetAPIVersion(gvk.GroupVersion().String())
|
|
||||||
u.SetKind(gvk.Kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GroupVersionKind() schema.GroupVersionKind {
|
|
||||||
gv, err := schema.ParseGroupVersion(u.GetAPIVersion())
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}
|
|
||||||
}
|
|
||||||
gvk := gv.WithKind(u.GetKind())
|
|
||||||
return gvk
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetFinalizers() []string {
|
|
||||||
return getNestedSlice(u.Object, "metadata", "finalizers")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetFinalizers(finalizers []string) {
|
|
||||||
u.setNestedSlice(finalizers, "metadata", "finalizers")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) GetClusterName() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "clusterName")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *Unstructured) SetClusterName(clusterName string) {
|
|
||||||
u.setNestedField(clusterName, "metadata", "clusterName")
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnstructuredList allows lists that do not have Golang structs
|
|
||||||
// registered to be manipulated generically. This can be used to deal
|
|
||||||
// with the API lists from a plug-in.
|
|
||||||
type UnstructuredList struct {
|
|
||||||
Object map[string]interface{}
|
|
||||||
|
|
||||||
// Items is a list of unstructured objects.
|
|
||||||
Items []*Unstructured `json:"items"`
|
|
||||||
}
|
|
||||||
|
|
||||||
// MarshalJSON ensures that the unstructured list object produces proper
|
|
||||||
// JSON when passed to Go's standard JSON library.
|
|
||||||
func (u *UnstructuredList) MarshalJSON() ([]byte, error) {
|
|
||||||
var buf bytes.Buffer
|
|
||||||
err := UnstructuredJSONScheme.Encode(u, &buf)
|
|
||||||
return buf.Bytes(), err
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnmarshalJSON ensures that the unstructured list object properly
|
|
||||||
// decodes JSON when passed to Go's standard JSON library.
|
|
||||||
func (u *UnstructuredList) UnmarshalJSON(b []byte) error {
|
|
||||||
_, _, err := UnstructuredJSONScheme.Decode(b, nil, u)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) setNestedField(value interface{}, fields ...string) {
|
|
||||||
if u.Object == nil {
|
|
||||||
u.Object = make(map[string]interface{})
|
|
||||||
}
|
|
||||||
setNestedField(u.Object, value, fields...)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) GetAPIVersion() string {
|
|
||||||
return getNestedString(u.Object, "apiVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) SetAPIVersion(version string) {
|
|
||||||
u.setNestedField(version, "apiVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) GetKind() string {
|
|
||||||
return getNestedString(u.Object, "kind")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) SetKind(kind string) {
|
|
||||||
u.setNestedField(kind, "kind")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) GetResourceVersion() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "resourceVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) SetResourceVersion(version string) {
|
|
||||||
u.setNestedField(version, "metadata", "resourceVersion")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) GetSelfLink() string {
|
|
||||||
return getNestedString(u.Object, "metadata", "selfLink")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) SetSelfLink(selfLink string) {
|
|
||||||
u.setNestedField(selfLink, "metadata", "selfLink")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) SetGroupVersionKind(gvk schema.GroupVersionKind) {
|
|
||||||
u.SetAPIVersion(gvk.GroupVersion().String())
|
|
||||||
u.SetKind(gvk.Kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (u *UnstructuredList) GroupVersionKind() schema.GroupVersionKind {
|
|
||||||
gv, err := schema.ParseGroupVersion(u.GetAPIVersion())
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}
|
|
||||||
}
|
|
||||||
gvk := gv.WithKind(u.GetKind())
|
|
||||||
return gvk
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnstructuredJSONScheme is capable of converting JSON data into the Unstructured
|
|
||||||
// type, which can be used for generic access to objects without a predefined scheme.
|
|
||||||
// TODO: move into serializer/json.
|
|
||||||
var UnstructuredJSONScheme runtime.Codec = unstructuredJSONScheme{}
|
|
||||||
|
|
||||||
type unstructuredJSONScheme struct{}
|
|
||||||
|
|
||||||
func (s unstructuredJSONScheme) Decode(data []byte, _ *schema.GroupVersionKind, obj runtime.Object) (runtime.Object, *schema.GroupVersionKind, error) {
|
|
||||||
var err error
|
|
||||||
if obj != nil {
|
|
||||||
err = s.decodeInto(data, obj)
|
|
||||||
} else {
|
|
||||||
obj, err = s.decode(data)
|
|
||||||
}
|
|
||||||
|
|
||||||
if err != nil {
|
|
||||||
return nil, nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
gvk := obj.GetObjectKind().GroupVersionKind()
|
|
||||||
if len(gvk.Kind) == 0 {
|
|
||||||
return nil, &gvk, runtime.NewMissingKindErr(string(data))
|
|
||||||
}
|
|
||||||
|
|
||||||
return obj, &gvk, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (unstructuredJSONScheme) Encode(obj runtime.Object, w io.Writer) error {
|
|
||||||
switch t := obj.(type) {
|
|
||||||
case *Unstructured:
|
|
||||||
return json.NewEncoder(w).Encode(t.Object)
|
|
||||||
case *UnstructuredList:
|
|
||||||
items := make([]map[string]interface{}, 0, len(t.Items))
|
|
||||||
for _, i := range t.Items {
|
|
||||||
items = append(items, i.Object)
|
|
||||||
}
|
|
||||||
t.Object["items"] = items
|
|
||||||
defer func() { delete(t.Object, "items") }()
|
|
||||||
return json.NewEncoder(w).Encode(t.Object)
|
|
||||||
case *runtime.Unknown:
|
|
||||||
// TODO: Unstructured needs to deal with ContentType.
|
|
||||||
_, err := w.Write(t.Raw)
|
|
||||||
return err
|
|
||||||
default:
|
|
||||||
return json.NewEncoder(w).Encode(t)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s unstructuredJSONScheme) decode(data []byte) (runtime.Object, error) {
|
|
||||||
type detector struct {
|
|
||||||
Items gojson.RawMessage
|
|
||||||
}
|
|
||||||
var det detector
|
|
||||||
if err := json.Unmarshal(data, &det); err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
if det.Items != nil {
|
|
||||||
list := &UnstructuredList{}
|
|
||||||
err := s.decodeToList(data, list)
|
|
||||||
return list, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// No Items field, so it wasn't a list.
|
|
||||||
unstruct := &Unstructured{}
|
|
||||||
err := s.decodeToUnstructured(data, unstruct)
|
|
||||||
return unstruct, err
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s unstructuredJSONScheme) decodeInto(data []byte, obj runtime.Object) error {
|
|
||||||
switch x := obj.(type) {
|
|
||||||
case *Unstructured:
|
|
||||||
return s.decodeToUnstructured(data, x)
|
|
||||||
case *UnstructuredList:
|
|
||||||
return s.decodeToList(data, x)
|
|
||||||
case *runtime.VersionedObjects:
|
|
||||||
o, err := s.decode(data)
|
|
||||||
if err == nil {
|
|
||||||
x.Objects = []runtime.Object{o}
|
|
||||||
}
|
|
||||||
return err
|
|
||||||
default:
|
|
||||||
return json.Unmarshal(data, x)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (unstructuredJSONScheme) decodeToUnstructured(data []byte, unstruct *Unstructured) error {
|
|
||||||
m := make(map[string]interface{})
|
|
||||||
if err := json.Unmarshal(data, &m); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
unstruct.Object = m
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s unstructuredJSONScheme) decodeToList(data []byte, list *UnstructuredList) error {
|
|
||||||
type decodeList struct {
|
|
||||||
Items []gojson.RawMessage
|
|
||||||
}
|
|
||||||
|
|
||||||
var dList decodeList
|
|
||||||
if err := json.Unmarshal(data, &dList); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := json.Unmarshal(data, &list.Object); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// For typed lists, e.g., a PodList, API server doesn't set each item's
|
|
||||||
// APIVersion and Kind. We need to set it.
|
|
||||||
listAPIVersion := list.GetAPIVersion()
|
|
||||||
listKind := list.GetKind()
|
|
||||||
itemKind := strings.TrimSuffix(listKind, "List")
|
|
||||||
|
|
||||||
delete(list.Object, "items")
|
|
||||||
list.Items = nil
|
|
||||||
for _, i := range dList.Items {
|
|
||||||
unstruct := &Unstructured{}
|
|
||||||
if err := s.decodeToUnstructured([]byte(i), unstruct); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
// This is hacky. Set the item's Kind and APIVersion to those inferred
|
|
||||||
// from the List.
|
|
||||||
if len(unstruct.GetKind()) == 0 && len(unstruct.GetAPIVersion()) == 0 {
|
|
||||||
unstruct.SetKind(itemKind)
|
|
||||||
unstruct.SetAPIVersion(listAPIVersion)
|
|
||||||
}
|
|
||||||
list.Items = append(list.Items, unstruct)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnstructuredObjectConverter is an ObjectConverter for use with
|
|
||||||
// Unstructured objects. Since it has no schema or type information,
|
|
||||||
// it will only succeed for no-op conversions. This is provided as a
|
|
||||||
// sane implementation for APIs that require an object converter.
|
|
||||||
type UnstructuredObjectConverter struct{}
|
|
||||||
|
|
||||||
func (UnstructuredObjectConverter) Convert(in, out, context interface{}) error {
|
|
||||||
unstructIn, ok := in.(*Unstructured)
|
|
||||||
if !ok {
|
|
||||||
return fmt.Errorf("input type %T in not valid for unstructured conversion", in)
|
|
||||||
}
|
|
||||||
|
|
||||||
unstructOut, ok := out.(*Unstructured)
|
|
||||||
if !ok {
|
|
||||||
return fmt.Errorf("output type %T in not valid for unstructured conversion", out)
|
|
||||||
}
|
|
||||||
|
|
||||||
// maybe deep copy the map? It is documented in the
|
|
||||||
// ObjectConverter interface that this function is not
|
|
||||||
// guaranteeed to not mutate the input. Or maybe set the input
|
|
||||||
// object to nil.
|
|
||||||
unstructOut.Object = unstructIn.Object
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (UnstructuredObjectConverter) ConvertToVersion(in runtime.Object, target runtime.GroupVersioner) (runtime.Object, error) {
|
|
||||||
if kind := in.GetObjectKind().GroupVersionKind(); !kind.Empty() {
|
|
||||||
gvk, ok := target.KindForGroupVersionKinds([]schema.GroupVersionKind{kind})
|
|
||||||
if !ok {
|
|
||||||
// TODO: should this be a typed error?
|
|
||||||
return nil, fmt.Errorf("%v is unstructured and is not suitable for converting to %q", kind, target)
|
|
||||||
}
|
|
||||||
in.GetObjectKind().SetGroupVersionKind(gvk)
|
|
||||||
}
|
|
||||||
return in, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (UnstructuredObjectConverter) ConvertFieldLabel(version, kind, label, value string) (string, string, error) {
|
|
||||||
return "", "", errors.New("unstructured cannot convert field labels")
|
|
||||||
}
|
|
||||||
@@ -1,80 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/watch"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Event represents a single event to a watched resource.
|
|
||||||
//
|
|
||||||
// +protobuf=true
|
|
||||||
type WatchEvent struct {
|
|
||||||
Type string `json:"type" protobuf:"bytes,1,opt,name=type"`
|
|
||||||
|
|
||||||
// Object is:
|
|
||||||
// * If Type is Added or Modified: the new state of the object.
|
|
||||||
// * If Type is Deleted: the state of the object immediately before deletion.
|
|
||||||
// * If Type is Error: *Status is recommended; other types may make sense
|
|
||||||
// depending on context.
|
|
||||||
Object runtime.RawExtension `json:"object" protobuf:"bytes,2,opt,name=object"`
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_watch_Event_to_versioned_Event(in *watch.Event, out *WatchEvent, s conversion.Scope) error {
|
|
||||||
out.Type = string(in.Type)
|
|
||||||
switch t := in.Object.(type) {
|
|
||||||
case *runtime.Unknown:
|
|
||||||
// TODO: handle other fields on Unknown and detect type
|
|
||||||
out.Object.Raw = t.Raw
|
|
||||||
case nil:
|
|
||||||
default:
|
|
||||||
out.Object.Object = in.Object
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_versioned_InternalEvent_to_versioned_Event(in *InternalEvent, out *WatchEvent, s conversion.Scope) error {
|
|
||||||
return Convert_watch_Event_to_versioned_Event((*watch.Event)(in), out, s)
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_versioned_Event_to_watch_Event(in *WatchEvent, out *watch.Event, s conversion.Scope) error {
|
|
||||||
out.Type = watch.EventType(in.Type)
|
|
||||||
if in.Object.Object != nil {
|
|
||||||
out.Object = in.Object.Object
|
|
||||||
} else if in.Object.Raw != nil {
|
|
||||||
// TODO: handle other fields on Unknown and detect type
|
|
||||||
out.Object = &runtime.Unknown{
|
|
||||||
Raw: in.Object.Raw,
|
|
||||||
ContentType: runtime.ContentTypeJSON,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_versioned_Event_to_versioned_InternalEvent(in *WatchEvent, out *InternalEvent, s conversion.Scope) error {
|
|
||||||
return Convert_versioned_Event_to_watch_Event(in, (*watch.Event)(out), s)
|
|
||||||
}
|
|
||||||
|
|
||||||
// InternalEvent makes watch.Event versioned
|
|
||||||
// +protobuf=false
|
|
||||||
type InternalEvent watch.Event
|
|
||||||
|
|
||||||
func (e *InternalEvent) GetObjectKind() schema.ObjectKind { return schema.EmptyObjectKind }
|
|
||||||
func (e *WatchEvent) GetObjectKind() schema.ObjectKind { return schema.EmptyObjectKind }
|
|
||||||
@@ -1,84 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 v1
|
|
||||||
|
|
||||||
const (
|
|
||||||
// If you add a new topology domain here, also consider adding it to the set of default values
|
|
||||||
// for the scheduler's --failure-domain command-line argument.
|
|
||||||
LabelHostname = "kubernetes.io/hostname"
|
|
||||||
LabelZoneFailureDomain = "failure-domain.beta.kubernetes.io/zone"
|
|
||||||
LabelZoneRegion = "failure-domain.beta.kubernetes.io/region"
|
|
||||||
|
|
||||||
LabelInstanceType = "beta.kubernetes.io/instance-type"
|
|
||||||
|
|
||||||
LabelOS = "beta.kubernetes.io/os"
|
|
||||||
LabelArch = "beta.kubernetes.io/arch"
|
|
||||||
|
|
||||||
// Historically fluentd was a manifest pod the was migrated to DaemonSet.
|
|
||||||
// To avoid situation during cluster upgrade when there are two instances
|
|
||||||
// of fluentd running on a node, kubelet need to mark node on which
|
|
||||||
// fluentd in not running as a manifest pod with LabelFluentdDsReady.
|
|
||||||
LabelFluentdDsReady = "alpha.kubernetes.io/fluentd-ds-ready"
|
|
||||||
|
|
||||||
// When the --use-taint-based-evictions flag is enabled,
|
|
||||||
// TaintNodeNotReady would be automatically added by node controller
|
|
||||||
// when node is not ready, and removed when node becomes ready.
|
|
||||||
TaintNodeNotReady = "node.alpha.kubernetes.io/notReady"
|
|
||||||
|
|
||||||
// When the --use-taint-based-evictions flag is enabled,
|
|
||||||
// TaintNodeUnreachable would be automatically added by node controller
|
|
||||||
// when node becomes unreachable (corresponding to NodeReady status ConditionUnknown)
|
|
||||||
// and removed when node becomes reachable (NodeReady status ConditionTrue).
|
|
||||||
TaintNodeUnreachable = "node.alpha.kubernetes.io/unreachable"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Role labels are applied to Nodes to mark their purpose. In particular, we
|
|
||||||
// usually want to distinguish the master, so that we can isolate privileged
|
|
||||||
// pods and operations.
|
|
||||||
//
|
|
||||||
// Originally we relied on not registering the master, on the fact that the
|
|
||||||
// master was Unschedulable, and on static manifests for master components.
|
|
||||||
// But we now do register masters in many environments, are generally moving
|
|
||||||
// away from static manifests (for better manageability), and working towards
|
|
||||||
// deprecating the unschedulable field (replacing it with taints & tolerations
|
|
||||||
// instead).
|
|
||||||
//
|
|
||||||
// Even with tainting, a label remains the easiest way of making a positive
|
|
||||||
// selection, so that pods can schedule only to master nodes for example, and
|
|
||||||
// thus installations will likely define a label for their master nodes.
|
|
||||||
//
|
|
||||||
// So that we can recognize master nodes in consequent places though (such as
|
|
||||||
// kubectl get nodes), we encourage installations to use the well-known labels.
|
|
||||||
// We define NodeLabelRole, which is the preferred form, but we will also recognize
|
|
||||||
// other forms that are known to be in widespread use (NodeLabelKubeadmAlphaRole).
|
|
||||||
|
|
||||||
const (
|
|
||||||
// NodeLabelRole is the preferred label applied to a Node as a hint that it has a particular purpose (defined by the value).
|
|
||||||
NodeLabelRole = "kubernetes.io/role"
|
|
||||||
|
|
||||||
// NodeLabelKubeadmAlphaRole is a label that kubeadm applies to a Node as a hint that it has a particular purpose.
|
|
||||||
// Use of NodeLabelRole is preferred.
|
|
||||||
NodeLabelKubeadmAlphaRole = "kubeadm.alpha.kubernetes.io/role"
|
|
||||||
|
|
||||||
// NodeLabelRoleMaster is the value of a NodeLabelRole or NodeLabelKubeadmAlphaRole label, indicating a master node.
|
|
||||||
// A master node typically runs kubernetes system components and will not typically run user workloads.
|
|
||||||
NodeLabelRoleMaster = "master"
|
|
||||||
|
|
||||||
// NodeLabelRoleNode is the value of a NodeLabelRole or NodeLabelKubeadmAlphaRole label, indicating a "normal" node,
|
|
||||||
// as opposed to a RoleMaster node.
|
|
||||||
NodeLabelRoleNode = "node"
|
|
||||||
)
|
|
||||||
@@ -1,544 +0,0 @@
|
|||||||
// +build !ignore_autogenerated
|
|
||||||
|
|
||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// This file was autogenerated by deepcopy-gen. Do not edit it manually!
|
|
||||||
|
|
||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
conversion "k8s.io/apimachinery/pkg/conversion"
|
|
||||||
runtime "k8s.io/apimachinery/pkg/runtime"
|
|
||||||
types "k8s.io/apimachinery/pkg/types"
|
|
||||||
reflect "reflect"
|
|
||||||
)
|
|
||||||
|
|
||||||
// GetGeneratedDeepCopyFuncs returns the generated funcs, since we aren't registering them.
|
|
||||||
func GetGeneratedDeepCopyFuncs() []conversion.GeneratedDeepCopyFunc {
|
|
||||||
return []conversion.GeneratedDeepCopyFunc{
|
|
||||||
{Fn: DeepCopy_v1_APIGroup, InType: reflect.TypeOf(&APIGroup{})},
|
|
||||||
{Fn: DeepCopy_v1_APIGroupList, InType: reflect.TypeOf(&APIGroupList{})},
|
|
||||||
{Fn: DeepCopy_v1_APIResource, InType: reflect.TypeOf(&APIResource{})},
|
|
||||||
{Fn: DeepCopy_v1_APIResourceList, InType: reflect.TypeOf(&APIResourceList{})},
|
|
||||||
{Fn: DeepCopy_v1_APIVersions, InType: reflect.TypeOf(&APIVersions{})},
|
|
||||||
{Fn: DeepCopy_v1_DeleteOptions, InType: reflect.TypeOf(&DeleteOptions{})},
|
|
||||||
{Fn: DeepCopy_v1_Duration, InType: reflect.TypeOf(&Duration{})},
|
|
||||||
{Fn: DeepCopy_v1_ExportOptions, InType: reflect.TypeOf(&ExportOptions{})},
|
|
||||||
{Fn: DeepCopy_v1_GetOptions, InType: reflect.TypeOf(&GetOptions{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupKind, InType: reflect.TypeOf(&GroupKind{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupResource, InType: reflect.TypeOf(&GroupResource{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupVersion, InType: reflect.TypeOf(&GroupVersion{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupVersionForDiscovery, InType: reflect.TypeOf(&GroupVersionForDiscovery{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupVersionKind, InType: reflect.TypeOf(&GroupVersionKind{})},
|
|
||||||
{Fn: DeepCopy_v1_GroupVersionResource, InType: reflect.TypeOf(&GroupVersionResource{})},
|
|
||||||
{Fn: DeepCopy_v1_InternalEvent, InType: reflect.TypeOf(&InternalEvent{})},
|
|
||||||
{Fn: DeepCopy_v1_LabelSelector, InType: reflect.TypeOf(&LabelSelector{})},
|
|
||||||
{Fn: DeepCopy_v1_LabelSelectorRequirement, InType: reflect.TypeOf(&LabelSelectorRequirement{})},
|
|
||||||
{Fn: DeepCopy_v1_ListMeta, InType: reflect.TypeOf(&ListMeta{})},
|
|
||||||
{Fn: DeepCopy_v1_ListOptions, InType: reflect.TypeOf(&ListOptions{})},
|
|
||||||
{Fn: DeepCopy_v1_ObjectMeta, InType: reflect.TypeOf(&ObjectMeta{})},
|
|
||||||
{Fn: DeepCopy_v1_OwnerReference, InType: reflect.TypeOf(&OwnerReference{})},
|
|
||||||
{Fn: DeepCopy_v1_Patch, InType: reflect.TypeOf(&Patch{})},
|
|
||||||
{Fn: DeepCopy_v1_Preconditions, InType: reflect.TypeOf(&Preconditions{})},
|
|
||||||
{Fn: DeepCopy_v1_RootPaths, InType: reflect.TypeOf(&RootPaths{})},
|
|
||||||
{Fn: DeepCopy_v1_ServerAddressByClientCIDR, InType: reflect.TypeOf(&ServerAddressByClientCIDR{})},
|
|
||||||
{Fn: DeepCopy_v1_Status, InType: reflect.TypeOf(&Status{})},
|
|
||||||
{Fn: DeepCopy_v1_StatusCause, InType: reflect.TypeOf(&StatusCause{})},
|
|
||||||
{Fn: DeepCopy_v1_StatusDetails, InType: reflect.TypeOf(&StatusDetails{})},
|
|
||||||
{Fn: DeepCopy_v1_Time, InType: reflect.TypeOf(&Time{})},
|
|
||||||
{Fn: DeepCopy_v1_Timestamp, InType: reflect.TypeOf(&Timestamp{})},
|
|
||||||
{Fn: DeepCopy_v1_TypeMeta, InType: reflect.TypeOf(&TypeMeta{})},
|
|
||||||
{Fn: DeepCopy_v1_WatchEvent, InType: reflect.TypeOf(&WatchEvent{})},
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_APIGroup(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*APIGroup)
|
|
||||||
out := out.(*APIGroup)
|
|
||||||
*out = *in
|
|
||||||
if in.Versions != nil {
|
|
||||||
in, out := &in.Versions, &out.Versions
|
|
||||||
*out = make([]GroupVersionForDiscovery, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
if in.ServerAddressByClientCIDRs != nil {
|
|
||||||
in, out := &in.ServerAddressByClientCIDRs, &out.ServerAddressByClientCIDRs
|
|
||||||
*out = make([]ServerAddressByClientCIDR, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_APIGroupList(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*APIGroupList)
|
|
||||||
out := out.(*APIGroupList)
|
|
||||||
*out = *in
|
|
||||||
if in.Groups != nil {
|
|
||||||
in, out := &in.Groups, &out.Groups
|
|
||||||
*out = make([]APIGroup, len(*in))
|
|
||||||
for i := range *in {
|
|
||||||
if newVal, err := c.DeepCopy(&(*in)[i]); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
(*out)[i] = *newVal.(*APIGroup)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_APIResource(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*APIResource)
|
|
||||||
out := out.(*APIResource)
|
|
||||||
*out = *in
|
|
||||||
if in.Verbs != nil {
|
|
||||||
in, out := &in.Verbs, &out.Verbs
|
|
||||||
*out = make(Verbs, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
if in.ShortNames != nil {
|
|
||||||
in, out := &in.ShortNames, &out.ShortNames
|
|
||||||
*out = make([]string, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_APIResourceList(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*APIResourceList)
|
|
||||||
out := out.(*APIResourceList)
|
|
||||||
*out = *in
|
|
||||||
if in.APIResources != nil {
|
|
||||||
in, out := &in.APIResources, &out.APIResources
|
|
||||||
*out = make([]APIResource, len(*in))
|
|
||||||
for i := range *in {
|
|
||||||
if newVal, err := c.DeepCopy(&(*in)[i]); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
(*out)[i] = *newVal.(*APIResource)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_APIVersions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*APIVersions)
|
|
||||||
out := out.(*APIVersions)
|
|
||||||
*out = *in
|
|
||||||
if in.Versions != nil {
|
|
||||||
in, out := &in.Versions, &out.Versions
|
|
||||||
*out = make([]string, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
if in.ServerAddressByClientCIDRs != nil {
|
|
||||||
in, out := &in.ServerAddressByClientCIDRs, &out.ServerAddressByClientCIDRs
|
|
||||||
*out = make([]ServerAddressByClientCIDR, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_DeleteOptions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*DeleteOptions)
|
|
||||||
out := out.(*DeleteOptions)
|
|
||||||
*out = *in
|
|
||||||
if in.GracePeriodSeconds != nil {
|
|
||||||
in, out := &in.GracePeriodSeconds, &out.GracePeriodSeconds
|
|
||||||
*out = new(int64)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
if in.Preconditions != nil {
|
|
||||||
in, out := &in.Preconditions, &out.Preconditions
|
|
||||||
if newVal, err := c.DeepCopy(*in); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
*out = newVal.(*Preconditions)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if in.OrphanDependents != nil {
|
|
||||||
in, out := &in.OrphanDependents, &out.OrphanDependents
|
|
||||||
*out = new(bool)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Duration(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Duration)
|
|
||||||
out := out.(*Duration)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_ExportOptions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*ExportOptions)
|
|
||||||
out := out.(*ExportOptions)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GetOptions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GetOptions)
|
|
||||||
out := out.(*GetOptions)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupKind(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupKind)
|
|
||||||
out := out.(*GroupKind)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupResource(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupResource)
|
|
||||||
out := out.(*GroupResource)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupVersion(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupVersion)
|
|
||||||
out := out.(*GroupVersion)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupVersionForDiscovery(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupVersionForDiscovery)
|
|
||||||
out := out.(*GroupVersionForDiscovery)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupVersionKind(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupVersionKind)
|
|
||||||
out := out.(*GroupVersionKind)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_GroupVersionResource(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*GroupVersionResource)
|
|
||||||
out := out.(*GroupVersionResource)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_InternalEvent(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*InternalEvent)
|
|
||||||
out := out.(*InternalEvent)
|
|
||||||
*out = *in
|
|
||||||
// in.Object is kind 'Interface'
|
|
||||||
if in.Object != nil {
|
|
||||||
if newVal, err := c.DeepCopy(&in.Object); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
out.Object = *newVal.(*runtime.Object)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_LabelSelector(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*LabelSelector)
|
|
||||||
out := out.(*LabelSelector)
|
|
||||||
*out = *in
|
|
||||||
if in.MatchLabels != nil {
|
|
||||||
in, out := &in.MatchLabels, &out.MatchLabels
|
|
||||||
*out = make(map[string]string)
|
|
||||||
for key, val := range *in {
|
|
||||||
(*out)[key] = val
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if in.MatchExpressions != nil {
|
|
||||||
in, out := &in.MatchExpressions, &out.MatchExpressions
|
|
||||||
*out = make([]LabelSelectorRequirement, len(*in))
|
|
||||||
for i := range *in {
|
|
||||||
if newVal, err := c.DeepCopy(&(*in)[i]); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
(*out)[i] = *newVal.(*LabelSelectorRequirement)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_LabelSelectorRequirement(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*LabelSelectorRequirement)
|
|
||||||
out := out.(*LabelSelectorRequirement)
|
|
||||||
*out = *in
|
|
||||||
if in.Values != nil {
|
|
||||||
in, out := &in.Values, &out.Values
|
|
||||||
*out = make([]string, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_ListMeta(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*ListMeta)
|
|
||||||
out := out.(*ListMeta)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_ListOptions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*ListOptions)
|
|
||||||
out := out.(*ListOptions)
|
|
||||||
*out = *in
|
|
||||||
if in.TimeoutSeconds != nil {
|
|
||||||
in, out := &in.TimeoutSeconds, &out.TimeoutSeconds
|
|
||||||
*out = new(int64)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_ObjectMeta(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*ObjectMeta)
|
|
||||||
out := out.(*ObjectMeta)
|
|
||||||
*out = *in
|
|
||||||
out.CreationTimestamp = in.CreationTimestamp.DeepCopy()
|
|
||||||
if in.DeletionTimestamp != nil {
|
|
||||||
in, out := &in.DeletionTimestamp, &out.DeletionTimestamp
|
|
||||||
*out = new(Time)
|
|
||||||
**out = (*in).DeepCopy()
|
|
||||||
}
|
|
||||||
if in.DeletionGracePeriodSeconds != nil {
|
|
||||||
in, out := &in.DeletionGracePeriodSeconds, &out.DeletionGracePeriodSeconds
|
|
||||||
*out = new(int64)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
if in.Labels != nil {
|
|
||||||
in, out := &in.Labels, &out.Labels
|
|
||||||
*out = make(map[string]string)
|
|
||||||
for key, val := range *in {
|
|
||||||
(*out)[key] = val
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if in.Annotations != nil {
|
|
||||||
in, out := &in.Annotations, &out.Annotations
|
|
||||||
*out = make(map[string]string)
|
|
||||||
for key, val := range *in {
|
|
||||||
(*out)[key] = val
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if in.OwnerReferences != nil {
|
|
||||||
in, out := &in.OwnerReferences, &out.OwnerReferences
|
|
||||||
*out = make([]OwnerReference, len(*in))
|
|
||||||
for i := range *in {
|
|
||||||
if newVal, err := c.DeepCopy(&(*in)[i]); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
(*out)[i] = *newVal.(*OwnerReference)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if in.Finalizers != nil {
|
|
||||||
in, out := &in.Finalizers, &out.Finalizers
|
|
||||||
*out = make([]string, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_OwnerReference(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*OwnerReference)
|
|
||||||
out := out.(*OwnerReference)
|
|
||||||
*out = *in
|
|
||||||
if in.Controller != nil {
|
|
||||||
in, out := &in.Controller, &out.Controller
|
|
||||||
*out = new(bool)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Patch(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Patch)
|
|
||||||
out := out.(*Patch)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Preconditions(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Preconditions)
|
|
||||||
out := out.(*Preconditions)
|
|
||||||
*out = *in
|
|
||||||
if in.UID != nil {
|
|
||||||
in, out := &in.UID, &out.UID
|
|
||||||
*out = new(types.UID)
|
|
||||||
**out = **in
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_RootPaths(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*RootPaths)
|
|
||||||
out := out.(*RootPaths)
|
|
||||||
*out = *in
|
|
||||||
if in.Paths != nil {
|
|
||||||
in, out := &in.Paths, &out.Paths
|
|
||||||
*out = make([]string, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_ServerAddressByClientCIDR(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*ServerAddressByClientCIDR)
|
|
||||||
out := out.(*ServerAddressByClientCIDR)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Status(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Status)
|
|
||||||
out := out.(*Status)
|
|
||||||
*out = *in
|
|
||||||
if in.Details != nil {
|
|
||||||
in, out := &in.Details, &out.Details
|
|
||||||
if newVal, err := c.DeepCopy(*in); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
*out = newVal.(*StatusDetails)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_StatusCause(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*StatusCause)
|
|
||||||
out := out.(*StatusCause)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_StatusDetails(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*StatusDetails)
|
|
||||||
out := out.(*StatusDetails)
|
|
||||||
*out = *in
|
|
||||||
if in.Causes != nil {
|
|
||||||
in, out := &in.Causes, &out.Causes
|
|
||||||
*out = make([]StatusCause, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Time(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Time)
|
|
||||||
out := out.(*Time)
|
|
||||||
*out = in.DeepCopy()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_Timestamp(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*Timestamp)
|
|
||||||
out := out.(*Timestamp)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_TypeMeta(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*TypeMeta)
|
|
||||||
out := out.(*TypeMeta)
|
|
||||||
*out = *in
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func DeepCopy_v1_WatchEvent(in interface{}, out interface{}, c *conversion.Cloner) error {
|
|
||||||
{
|
|
||||||
in := in.(*WatchEvent)
|
|
||||||
out := out.(*WatchEvent)
|
|
||||||
*out = *in
|
|
||||||
if newVal, err := c.DeepCopy(&in.Object); err != nil {
|
|
||||||
return err
|
|
||||||
} else {
|
|
||||||
out.Object = *newVal.(*runtime.RawExtension)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,32 +0,0 @@
|
|||||||
// +build !ignore_autogenerated
|
|
||||||
|
|
||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// This file was autogenerated by defaulter-gen. Do not edit it manually!
|
|
||||||
|
|
||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
runtime "k8s.io/apimachinery/pkg/runtime"
|
|
||||||
)
|
|
||||||
|
|
||||||
// RegisterDefaults adds defaulters functions to the given scheme.
|
|
||||||
// Public to allow building arbitrary schemes.
|
|
||||||
// All generated defaulters are covering - they call all nested defaulters.
|
|
||||||
func RegisterDefaults(scheme *runtime.Scheme) error {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
approvers:
|
|
||||||
- derekwaynecarr
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
reviewers:
|
|
||||||
- derekwaynecarr
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
@@ -1,249 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 conversion
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Cloner knows how to copy one type to another.
|
|
||||||
type Cloner struct {
|
|
||||||
// Map from the type to a function which can do the deep copy.
|
|
||||||
deepCopyFuncs map[reflect.Type]reflect.Value
|
|
||||||
generatedDeepCopyFuncs map[reflect.Type]func(in interface{}, out interface{}, c *Cloner) error
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewCloner creates a new Cloner object.
|
|
||||||
func NewCloner() *Cloner {
|
|
||||||
c := &Cloner{
|
|
||||||
deepCopyFuncs: map[reflect.Type]reflect.Value{},
|
|
||||||
generatedDeepCopyFuncs: map[reflect.Type]func(in interface{}, out interface{}, c *Cloner) error{},
|
|
||||||
}
|
|
||||||
if err := c.RegisterDeepCopyFunc(byteSliceDeepCopy); err != nil {
|
|
||||||
// If one of the deep-copy functions is malformed, detect it immediately.
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return c
|
|
||||||
}
|
|
||||||
|
|
||||||
// Prevent recursing into every byte...
|
|
||||||
func byteSliceDeepCopy(in *[]byte, out *[]byte, c *Cloner) error {
|
|
||||||
if *in != nil {
|
|
||||||
*out = make([]byte, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
} else {
|
|
||||||
*out = nil
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verifies whether a deep-copy function has a correct signature.
|
|
||||||
func verifyDeepCopyFunctionSignature(ft reflect.Type) error {
|
|
||||||
if ft.Kind() != reflect.Func {
|
|
||||||
return fmt.Errorf("expected func, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumIn() != 3 {
|
|
||||||
return fmt.Errorf("expected three 'in' params, got %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumOut() != 1 {
|
|
||||||
return fmt.Errorf("expected one 'out' param, got %v", ft)
|
|
||||||
}
|
|
||||||
if ft.In(0).Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'in' param 0, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.In(1) != ft.In(0) {
|
|
||||||
return fmt.Errorf("expected 'in' param 0 the same as param 1, got: %v", ft)
|
|
||||||
}
|
|
||||||
var forClonerType Cloner
|
|
||||||
if expected := reflect.TypeOf(&forClonerType); ft.In(2) != expected {
|
|
||||||
return fmt.Errorf("expected '%v' arg for 'in' param 2, got: '%v'", expected, ft.In(2))
|
|
||||||
}
|
|
||||||
var forErrorType error
|
|
||||||
// This convolution is necessary, otherwise TypeOf picks up on the fact
|
|
||||||
// that forErrorType is nil
|
|
||||||
errorType := reflect.TypeOf(&forErrorType).Elem()
|
|
||||||
if ft.Out(0) != errorType {
|
|
||||||
return fmt.Errorf("expected error return, got: %v", ft)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterGeneratedDeepCopyFunc registers a copying func with the Cloner.
|
|
||||||
// deepCopyFunc must take three parameters: a type input, a pointer to a
|
|
||||||
// type output, and a pointer to Cloner. It should return an error.
|
|
||||||
//
|
|
||||||
// Example:
|
|
||||||
// c.RegisterGeneratedDeepCopyFunc(
|
|
||||||
// func(in Pod, out *Pod, c *Cloner) error {
|
|
||||||
// // deep copy logic...
|
|
||||||
// return nil
|
|
||||||
// })
|
|
||||||
func (c *Cloner) RegisterDeepCopyFunc(deepCopyFunc interface{}) error {
|
|
||||||
fv := reflect.ValueOf(deepCopyFunc)
|
|
||||||
ft := fv.Type()
|
|
||||||
if err := verifyDeepCopyFunctionSignature(ft); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
c.deepCopyFuncs[ft.In(0)] = fv
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// GeneratedDeepCopyFunc bundles an untyped generated deep-copy function of a type
|
|
||||||
// with a reflection type object used as a key to lookup the deep-copy function.
|
|
||||||
type GeneratedDeepCopyFunc struct {
|
|
||||||
Fn func(in interface{}, out interface{}, c *Cloner) error
|
|
||||||
InType reflect.Type
|
|
||||||
}
|
|
||||||
|
|
||||||
// Similar to RegisterDeepCopyFunc, but registers deep copy function that were
|
|
||||||
// automatically generated.
|
|
||||||
func (c *Cloner) RegisterGeneratedDeepCopyFunc(fn GeneratedDeepCopyFunc) error {
|
|
||||||
c.generatedDeepCopyFuncs[fn.InType] = fn.Fn
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// DeepCopy will perform a deep copy of a given object.
|
|
||||||
func (c *Cloner) DeepCopy(in interface{}) (interface{}, error) {
|
|
||||||
// Can be invalid if we run DeepCopy(X) where X is a nil interface type.
|
|
||||||
// For example, we get an invalid value when someone tries to deep-copy
|
|
||||||
// a nil labels.Selector.
|
|
||||||
// This does not occur if X is nil and is a pointer to a concrete type.
|
|
||||||
if in == nil {
|
|
||||||
return nil, nil
|
|
||||||
}
|
|
||||||
inValue := reflect.ValueOf(in)
|
|
||||||
outValue, err := c.deepCopy(inValue)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return outValue.Interface(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *Cloner) deepCopy(src reflect.Value) (reflect.Value, error) {
|
|
||||||
inType := src.Type()
|
|
||||||
|
|
||||||
switch src.Kind() {
|
|
||||||
case reflect.Interface, reflect.Ptr, reflect.Map, reflect.Slice:
|
|
||||||
if src.IsNil() {
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if fv, ok := c.deepCopyFuncs[inType]; ok {
|
|
||||||
return c.customDeepCopy(src, fv)
|
|
||||||
}
|
|
||||||
if fv, ok := c.generatedDeepCopyFuncs[inType]; ok {
|
|
||||||
var outValue reflect.Value
|
|
||||||
outValue = reflect.New(inType.Elem())
|
|
||||||
err := fv(src.Interface(), outValue.Interface(), c)
|
|
||||||
return outValue, err
|
|
||||||
}
|
|
||||||
return c.defaultDeepCopy(src)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *Cloner) customDeepCopy(src, fv reflect.Value) (reflect.Value, error) {
|
|
||||||
outValue := reflect.New(src.Type().Elem())
|
|
||||||
args := []reflect.Value{src, outValue, reflect.ValueOf(c)}
|
|
||||||
result := fv.Call(args)[0].Interface()
|
|
||||||
// This convolution is necessary because nil interfaces won't convert
|
|
||||||
// to error.
|
|
||||||
if result == nil {
|
|
||||||
return outValue, nil
|
|
||||||
}
|
|
||||||
return outValue, result.(error)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *Cloner) defaultDeepCopy(src reflect.Value) (reflect.Value, error) {
|
|
||||||
switch src.Kind() {
|
|
||||||
case reflect.Chan, reflect.Func, reflect.UnsafePointer, reflect.Uintptr:
|
|
||||||
return src, fmt.Errorf("cannot deep copy kind: %s", src.Kind())
|
|
||||||
case reflect.Array:
|
|
||||||
dst := reflect.New(src.Type())
|
|
||||||
for i := 0; i < src.Len(); i++ {
|
|
||||||
copyVal, err := c.deepCopy(src.Index(i))
|
|
||||||
if err != nil {
|
|
||||||
return src, err
|
|
||||||
}
|
|
||||||
dst.Elem().Index(i).Set(copyVal)
|
|
||||||
}
|
|
||||||
return dst.Elem(), nil
|
|
||||||
case reflect.Interface:
|
|
||||||
if src.IsNil() {
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
return c.deepCopy(src.Elem())
|
|
||||||
case reflect.Map:
|
|
||||||
if src.IsNil() {
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
dst := reflect.MakeMap(src.Type())
|
|
||||||
for _, k := range src.MapKeys() {
|
|
||||||
copyVal, err := c.deepCopy(src.MapIndex(k))
|
|
||||||
if err != nil {
|
|
||||||
return src, err
|
|
||||||
}
|
|
||||||
dst.SetMapIndex(k, copyVal)
|
|
||||||
}
|
|
||||||
return dst, nil
|
|
||||||
case reflect.Ptr:
|
|
||||||
if src.IsNil() {
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
dst := reflect.New(src.Type().Elem())
|
|
||||||
copyVal, err := c.deepCopy(src.Elem())
|
|
||||||
if err != nil {
|
|
||||||
return src, err
|
|
||||||
}
|
|
||||||
dst.Elem().Set(copyVal)
|
|
||||||
return dst, nil
|
|
||||||
case reflect.Slice:
|
|
||||||
if src.IsNil() {
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
dst := reflect.MakeSlice(src.Type(), 0, src.Len())
|
|
||||||
for i := 0; i < src.Len(); i++ {
|
|
||||||
copyVal, err := c.deepCopy(src.Index(i))
|
|
||||||
if err != nil {
|
|
||||||
return src, err
|
|
||||||
}
|
|
||||||
dst = reflect.Append(dst, copyVal)
|
|
||||||
}
|
|
||||||
return dst, nil
|
|
||||||
case reflect.Struct:
|
|
||||||
dst := reflect.New(src.Type())
|
|
||||||
for i := 0; i < src.NumField(); i++ {
|
|
||||||
if !dst.Elem().Field(i).CanSet() {
|
|
||||||
// Can't set private fields. At this point, the
|
|
||||||
// best we can do is a shallow copy. For
|
|
||||||
// example, time.Time is a value type with
|
|
||||||
// private members that can be shallow copied.
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
copyVal, err := c.deepCopy(src.Field(i))
|
|
||||||
if err != nil {
|
|
||||||
return src, err
|
|
||||||
}
|
|
||||||
dst.Elem().Field(i).Set(copyVal)
|
|
||||||
}
|
|
||||||
return dst.Elem(), nil
|
|
||||||
|
|
||||||
default:
|
|
||||||
// Value types like numbers, booleans, and strings.
|
|
||||||
return src, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,953 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 conversion
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
)
|
|
||||||
|
|
||||||
type typePair struct {
|
|
||||||
source reflect.Type
|
|
||||||
dest reflect.Type
|
|
||||||
}
|
|
||||||
|
|
||||||
type typeNamePair struct {
|
|
||||||
fieldType reflect.Type
|
|
||||||
fieldName string
|
|
||||||
}
|
|
||||||
|
|
||||||
// DebugLogger allows you to get debugging messages if necessary.
|
|
||||||
type DebugLogger interface {
|
|
||||||
Logf(format string, args ...interface{})
|
|
||||||
}
|
|
||||||
|
|
||||||
type NameFunc func(t reflect.Type) string
|
|
||||||
|
|
||||||
var DefaultNameFunc = func(t reflect.Type) string { return t.Name() }
|
|
||||||
|
|
||||||
type GenericConversionFunc func(a, b interface{}, scope Scope) (bool, error)
|
|
||||||
|
|
||||||
// Converter knows how to convert one type to another.
|
|
||||||
type Converter struct {
|
|
||||||
// Map from the conversion pair to a function which can
|
|
||||||
// do the conversion.
|
|
||||||
conversionFuncs ConversionFuncs
|
|
||||||
generatedConversionFuncs ConversionFuncs
|
|
||||||
|
|
||||||
// genericConversions are called during normal conversion to offer a "fast-path"
|
|
||||||
// that avoids all reflection. These methods are not called outside of the .Convert()
|
|
||||||
// method.
|
|
||||||
genericConversions []GenericConversionFunc
|
|
||||||
|
|
||||||
// Set of conversions that should be treated as a no-op
|
|
||||||
ignoredConversions map[typePair]struct{}
|
|
||||||
|
|
||||||
// This is a map from a source field type and name, to a list of destination
|
|
||||||
// field type and name.
|
|
||||||
structFieldDests map[typeNamePair][]typeNamePair
|
|
||||||
|
|
||||||
// Allows for the opposite lookup of structFieldDests. So that SourceFromDest
|
|
||||||
// copy flag also works. So this is a map of destination field name, to potential
|
|
||||||
// source field name and type to look for.
|
|
||||||
structFieldSources map[typeNamePair][]typeNamePair
|
|
||||||
|
|
||||||
// Map from a type to a function which applies defaults.
|
|
||||||
defaultingFuncs map[reflect.Type]reflect.Value
|
|
||||||
|
|
||||||
// Similar to above, but function is stored as interface{}.
|
|
||||||
defaultingInterfaces map[reflect.Type]interface{}
|
|
||||||
|
|
||||||
// Map from an input type to a function which can apply a key name mapping
|
|
||||||
inputFieldMappingFuncs map[reflect.Type]FieldMappingFunc
|
|
||||||
|
|
||||||
// Map from an input type to a set of default conversion flags.
|
|
||||||
inputDefaultFlags map[reflect.Type]FieldMatchingFlags
|
|
||||||
|
|
||||||
// If non-nil, will be called to print helpful debugging info. Quite verbose.
|
|
||||||
Debug DebugLogger
|
|
||||||
|
|
||||||
// nameFunc is called to retrieve the name of a type; this name is used for the
|
|
||||||
// purpose of deciding whether two types match or not (i.e., will we attempt to
|
|
||||||
// do a conversion). The default returns the go type name.
|
|
||||||
nameFunc func(t reflect.Type) string
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewConverter creates a new Converter object.
|
|
||||||
func NewConverter(nameFn NameFunc) *Converter {
|
|
||||||
c := &Converter{
|
|
||||||
conversionFuncs: NewConversionFuncs(),
|
|
||||||
generatedConversionFuncs: NewConversionFuncs(),
|
|
||||||
ignoredConversions: make(map[typePair]struct{}),
|
|
||||||
defaultingFuncs: make(map[reflect.Type]reflect.Value),
|
|
||||||
defaultingInterfaces: make(map[reflect.Type]interface{}),
|
|
||||||
nameFunc: nameFn,
|
|
||||||
structFieldDests: make(map[typeNamePair][]typeNamePair),
|
|
||||||
structFieldSources: make(map[typeNamePair][]typeNamePair),
|
|
||||||
|
|
||||||
inputFieldMappingFuncs: make(map[reflect.Type]FieldMappingFunc),
|
|
||||||
inputDefaultFlags: make(map[reflect.Type]FieldMatchingFlags),
|
|
||||||
}
|
|
||||||
c.RegisterConversionFunc(Convert_Slice_byte_To_Slice_byte)
|
|
||||||
return c
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddGenericConversionFunc adds a function that accepts the ConversionFunc call pattern
|
|
||||||
// (for two conversion types) to the converter. These functions are checked first during
|
|
||||||
// a normal conversion, but are otherwise not called. Use AddConversionFuncs when registering
|
|
||||||
// typed conversions.
|
|
||||||
func (c *Converter) AddGenericConversionFunc(fn GenericConversionFunc) {
|
|
||||||
c.genericConversions = append(c.genericConversions, fn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithConversions returns a Converter that is a copy of c but with the additional
|
|
||||||
// fns merged on top.
|
|
||||||
func (c *Converter) WithConversions(fns ConversionFuncs) *Converter {
|
|
||||||
copied := *c
|
|
||||||
copied.conversionFuncs = c.conversionFuncs.Merge(fns)
|
|
||||||
return &copied
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultMeta returns the conversion FieldMappingFunc and meta for a given type.
|
|
||||||
func (c *Converter) DefaultMeta(t reflect.Type) (FieldMatchingFlags, *Meta) {
|
|
||||||
return c.inputDefaultFlags[t], &Meta{
|
|
||||||
KeyNameMapping: c.inputFieldMappingFuncs[t],
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert_Slice_byte_To_Slice_byte prevents recursing into every byte
|
|
||||||
func Convert_Slice_byte_To_Slice_byte(in *[]byte, out *[]byte, s Scope) error {
|
|
||||||
if *in == nil {
|
|
||||||
*out = nil
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
*out = make([]byte, len(*in))
|
|
||||||
copy(*out, *in)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Scope is passed to conversion funcs to allow them to continue an ongoing conversion.
|
|
||||||
// If multiple converters exist in the system, Scope will allow you to use the correct one
|
|
||||||
// from a conversion function--that is, the one your conversion function was called by.
|
|
||||||
type Scope interface {
|
|
||||||
// Call Convert to convert sub-objects. Note that if you call it with your own exact
|
|
||||||
// parameters, you'll run out of stack space before anything useful happens.
|
|
||||||
Convert(src, dest interface{}, flags FieldMatchingFlags) error
|
|
||||||
|
|
||||||
// DefaultConvert performs the default conversion, without calling a conversion func
|
|
||||||
// on the current stack frame. This makes it safe to call from a conversion func.
|
|
||||||
DefaultConvert(src, dest interface{}, flags FieldMatchingFlags) error
|
|
||||||
|
|
||||||
// If registered, returns a function applying defaults for objects of a given type.
|
|
||||||
// Used for automatically generating conversion functions.
|
|
||||||
DefaultingInterface(inType reflect.Type) (interface{}, bool)
|
|
||||||
|
|
||||||
// SrcTags and DestTags contain the struct tags that src and dest had, respectively.
|
|
||||||
// If the enclosing object was not a struct, then these will contain no tags, of course.
|
|
||||||
SrcTag() reflect.StructTag
|
|
||||||
DestTag() reflect.StructTag
|
|
||||||
|
|
||||||
// Flags returns the flags with which the conversion was started.
|
|
||||||
Flags() FieldMatchingFlags
|
|
||||||
|
|
||||||
// Meta returns any information originally passed to Convert.
|
|
||||||
Meta() *Meta
|
|
||||||
}
|
|
||||||
|
|
||||||
// FieldMappingFunc can convert an input field value into different values, depending on
|
|
||||||
// the value of the source or destination struct tags.
|
|
||||||
type FieldMappingFunc func(key string, sourceTag, destTag reflect.StructTag) (source string, dest string)
|
|
||||||
|
|
||||||
func NewConversionFuncs() ConversionFuncs {
|
|
||||||
return ConversionFuncs{fns: make(map[typePair]reflect.Value)}
|
|
||||||
}
|
|
||||||
|
|
||||||
type ConversionFuncs struct {
|
|
||||||
fns map[typePair]reflect.Value
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add adds the provided conversion functions to the lookup table - they must have the signature
|
|
||||||
// `func(type1, type2, Scope) error`. Functions are added in the order passed and will override
|
|
||||||
// previously registered pairs.
|
|
||||||
func (c ConversionFuncs) Add(fns ...interface{}) error {
|
|
||||||
for _, fn := range fns {
|
|
||||||
fv := reflect.ValueOf(fn)
|
|
||||||
ft := fv.Type()
|
|
||||||
if err := verifyConversionFunctionSignature(ft); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
c.fns[typePair{ft.In(0).Elem(), ft.In(1).Elem()}] = fv
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Merge returns a new ConversionFuncs that contains all conversions from
|
|
||||||
// both other and c, with other conversions taking precedence.
|
|
||||||
func (c ConversionFuncs) Merge(other ConversionFuncs) ConversionFuncs {
|
|
||||||
merged := NewConversionFuncs()
|
|
||||||
for k, v := range c.fns {
|
|
||||||
merged.fns[k] = v
|
|
||||||
}
|
|
||||||
for k, v := range other.fns {
|
|
||||||
merged.fns[k] = v
|
|
||||||
}
|
|
||||||
return merged
|
|
||||||
}
|
|
||||||
|
|
||||||
// Meta is supplied by Scheme, when it calls Convert.
|
|
||||||
type Meta struct {
|
|
||||||
// KeyNameMapping is an optional function which may map the listed key (field name)
|
|
||||||
// into a source and destination value.
|
|
||||||
KeyNameMapping FieldMappingFunc
|
|
||||||
// Context is an optional field that callers may use to pass info to conversion functions.
|
|
||||||
Context interface{}
|
|
||||||
}
|
|
||||||
|
|
||||||
// scope contains information about an ongoing conversion.
|
|
||||||
type scope struct {
|
|
||||||
converter *Converter
|
|
||||||
meta *Meta
|
|
||||||
flags FieldMatchingFlags
|
|
||||||
|
|
||||||
// srcStack & destStack are separate because they may not have a 1:1
|
|
||||||
// relationship.
|
|
||||||
srcStack scopeStack
|
|
||||||
destStack scopeStack
|
|
||||||
}
|
|
||||||
|
|
||||||
type scopeStackElem struct {
|
|
||||||
tag reflect.StructTag
|
|
||||||
value reflect.Value
|
|
||||||
key string
|
|
||||||
}
|
|
||||||
|
|
||||||
type scopeStack []scopeStackElem
|
|
||||||
|
|
||||||
func (s *scopeStack) pop() {
|
|
||||||
n := len(*s)
|
|
||||||
*s = (*s)[:n-1]
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s *scopeStack) push(e scopeStackElem) {
|
|
||||||
*s = append(*s, e)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s *scopeStack) top() *scopeStackElem {
|
|
||||||
return &(*s)[len(*s)-1]
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s scopeStack) describe() string {
|
|
||||||
desc := ""
|
|
||||||
if len(s) > 1 {
|
|
||||||
desc = "(" + s[1].value.Type().String() + ")"
|
|
||||||
}
|
|
||||||
for i, v := range s {
|
|
||||||
if i < 2 {
|
|
||||||
// First layer on stack is not real; second is handled specially above.
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if v.key == "" {
|
|
||||||
desc += fmt.Sprintf(".%v", v.value.Type())
|
|
||||||
} else {
|
|
||||||
desc += fmt.Sprintf(".%v", v.key)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return desc
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s *scope) DefaultingInterface(inType reflect.Type) (interface{}, bool) {
|
|
||||||
value, found := s.converter.defaultingInterfaces[inType]
|
|
||||||
return value, found
|
|
||||||
}
|
|
||||||
|
|
||||||
// Formats src & dest as indices for printing.
|
|
||||||
func (s *scope) setIndices(src, dest int) {
|
|
||||||
s.srcStack.top().key = fmt.Sprintf("[%v]", src)
|
|
||||||
s.destStack.top().key = fmt.Sprintf("[%v]", dest)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Formats src & dest as map keys for printing.
|
|
||||||
func (s *scope) setKeys(src, dest interface{}) {
|
|
||||||
s.srcStack.top().key = fmt.Sprintf(`["%v"]`, src)
|
|
||||||
s.destStack.top().key = fmt.Sprintf(`["%v"]`, dest)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert continues a conversion.
|
|
||||||
func (s *scope) Convert(src, dest interface{}, flags FieldMatchingFlags) error {
|
|
||||||
return s.converter.Convert(src, dest, flags, s.meta)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultConvert continues a conversion, performing a default conversion (no conversion func)
|
|
||||||
// for the current stack frame.
|
|
||||||
func (s *scope) DefaultConvert(src, dest interface{}, flags FieldMatchingFlags) error {
|
|
||||||
return s.converter.DefaultConvert(src, dest, flags, s.meta)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SrcTag returns the tag of the struct containing the current source item, if any.
|
|
||||||
func (s *scope) SrcTag() reflect.StructTag {
|
|
||||||
return s.srcStack.top().tag
|
|
||||||
}
|
|
||||||
|
|
||||||
// DestTag returns the tag of the struct containing the current dest item, if any.
|
|
||||||
func (s *scope) DestTag() reflect.StructTag {
|
|
||||||
return s.destStack.top().tag
|
|
||||||
}
|
|
||||||
|
|
||||||
// Flags returns the flags with which the current conversion was started.
|
|
||||||
func (s *scope) Flags() FieldMatchingFlags {
|
|
||||||
return s.flags
|
|
||||||
}
|
|
||||||
|
|
||||||
// Meta returns the meta object that was originally passed to Convert.
|
|
||||||
func (s *scope) Meta() *Meta {
|
|
||||||
return s.meta
|
|
||||||
}
|
|
||||||
|
|
||||||
// describe prints the path to get to the current (source, dest) values.
|
|
||||||
func (s *scope) describe() (src, dest string) {
|
|
||||||
return s.srcStack.describe(), s.destStack.describe()
|
|
||||||
}
|
|
||||||
|
|
||||||
// error makes an error that includes information about where we were in the objects
|
|
||||||
// we were asked to convert.
|
|
||||||
func (s *scope) errorf(message string, args ...interface{}) error {
|
|
||||||
srcPath, destPath := s.describe()
|
|
||||||
where := fmt.Sprintf("converting %v to %v: ", srcPath, destPath)
|
|
||||||
return fmt.Errorf(where+message, args...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verifies whether a conversion function has a correct signature.
|
|
||||||
func verifyConversionFunctionSignature(ft reflect.Type) error {
|
|
||||||
if ft.Kind() != reflect.Func {
|
|
||||||
return fmt.Errorf("expected func, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumIn() != 3 {
|
|
||||||
return fmt.Errorf("expected three 'in' params, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumOut() != 1 {
|
|
||||||
return fmt.Errorf("expected one 'out' param, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.In(0).Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'in' param 0, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.In(1).Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'in' param 1, got: %v", ft)
|
|
||||||
}
|
|
||||||
scopeType := Scope(nil)
|
|
||||||
if e, a := reflect.TypeOf(&scopeType).Elem(), ft.In(2); e != a {
|
|
||||||
return fmt.Errorf("expected '%v' arg for 'in' param 2, got '%v' (%v)", e, a, ft)
|
|
||||||
}
|
|
||||||
var forErrorType error
|
|
||||||
// This convolution is necessary, otherwise TypeOf picks up on the fact
|
|
||||||
// that forErrorType is nil.
|
|
||||||
errorType := reflect.TypeOf(&forErrorType).Elem()
|
|
||||||
if ft.Out(0) != errorType {
|
|
||||||
return fmt.Errorf("expected error return, got: %v", ft)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterConversionFunc registers a conversion func with the
|
|
||||||
// Converter. conversionFunc must take three parameters: a pointer to the input
|
|
||||||
// type, a pointer to the output type, and a conversion.Scope (which should be
|
|
||||||
// used if recursive conversion calls are desired). It must return an error.
|
|
||||||
//
|
|
||||||
// Example:
|
|
||||||
// c.RegisterConversionFunc(
|
|
||||||
// func(in *Pod, out *v1.Pod, s Scope) error {
|
|
||||||
// // conversion logic...
|
|
||||||
// return nil
|
|
||||||
// })
|
|
||||||
func (c *Converter) RegisterConversionFunc(conversionFunc interface{}) error {
|
|
||||||
return c.conversionFuncs.Add(conversionFunc)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Similar to RegisterConversionFunc, but registers conversion function that were
|
|
||||||
// automatically generated.
|
|
||||||
func (c *Converter) RegisterGeneratedConversionFunc(conversionFunc interface{}) error {
|
|
||||||
return c.generatedConversionFuncs.Add(conversionFunc)
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterIgnoredConversion registers a "no-op" for conversion, where any requested
|
|
||||||
// conversion between from and to is ignored.
|
|
||||||
func (c *Converter) RegisterIgnoredConversion(from, to interface{}) error {
|
|
||||||
typeFrom := reflect.TypeOf(from)
|
|
||||||
typeTo := reflect.TypeOf(to)
|
|
||||||
if reflect.TypeOf(from).Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'from' param 0, got: %v", typeFrom)
|
|
||||||
}
|
|
||||||
if typeTo.Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'to' param 1, got: %v", typeTo)
|
|
||||||
}
|
|
||||||
c.ignoredConversions[typePair{typeFrom.Elem(), typeTo.Elem()}] = struct{}{}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsConversionIgnored returns true if the specified objects should be dropped during
|
|
||||||
// conversion.
|
|
||||||
func (c *Converter) IsConversionIgnored(inType, outType reflect.Type) bool {
|
|
||||||
_, found := c.ignoredConversions[typePair{inType, outType}]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *Converter) HasConversionFunc(inType, outType reflect.Type) bool {
|
|
||||||
_, found := c.conversionFuncs.fns[typePair{inType, outType}]
|
|
||||||
return found
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *Converter) ConversionFuncValue(inType, outType reflect.Type) (reflect.Value, bool) {
|
|
||||||
value, found := c.conversionFuncs.fns[typePair{inType, outType}]
|
|
||||||
return value, found
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetStructFieldCopy registers a correspondence. Whenever a struct field is encountered
|
|
||||||
// which has a type and name matching srcFieldType and srcFieldName, it wil be copied
|
|
||||||
// into the field in the destination struct matching destFieldType & Name, if such a
|
|
||||||
// field exists.
|
|
||||||
// May be called multiple times, even for the same source field & type--all applicable
|
|
||||||
// copies will be performed.
|
|
||||||
func (c *Converter) SetStructFieldCopy(srcFieldType interface{}, srcFieldName string, destFieldType interface{}, destFieldName string) error {
|
|
||||||
st := reflect.TypeOf(srcFieldType)
|
|
||||||
dt := reflect.TypeOf(destFieldType)
|
|
||||||
srcKey := typeNamePair{st, srcFieldName}
|
|
||||||
destKey := typeNamePair{dt, destFieldName}
|
|
||||||
c.structFieldDests[srcKey] = append(c.structFieldDests[srcKey], destKey)
|
|
||||||
c.structFieldSources[destKey] = append(c.structFieldSources[destKey], srcKey)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterDefaultingFunc registers a value-defaulting func with the Converter.
|
|
||||||
// defaultingFunc must take one parameter: a pointer to the input type.
|
|
||||||
//
|
|
||||||
// Example:
|
|
||||||
// c.RegisterDefaultingFunc(
|
|
||||||
// func(in *v1.Pod) {
|
|
||||||
// // defaulting logic...
|
|
||||||
// })
|
|
||||||
func (c *Converter) RegisterDefaultingFunc(defaultingFunc interface{}) error {
|
|
||||||
fv := reflect.ValueOf(defaultingFunc)
|
|
||||||
ft := fv.Type()
|
|
||||||
if ft.Kind() != reflect.Func {
|
|
||||||
return fmt.Errorf("expected func, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumIn() != 1 {
|
|
||||||
return fmt.Errorf("expected one 'in' param, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.NumOut() != 0 {
|
|
||||||
return fmt.Errorf("expected zero 'out' params, got: %v", ft)
|
|
||||||
}
|
|
||||||
if ft.In(0).Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer arg for 'in' param 0, got: %v", ft)
|
|
||||||
}
|
|
||||||
inType := ft.In(0).Elem()
|
|
||||||
c.defaultingFuncs[inType] = fv
|
|
||||||
c.defaultingInterfaces[inType] = defaultingFunc
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterInputDefaults registers a field name mapping function, used when converting
|
|
||||||
// from maps to structs. Inputs to the conversion methods are checked for this type and a mapping
|
|
||||||
// applied automatically if the input matches in. A set of default flags for the input conversion
|
|
||||||
// may also be provided, which will be used when no explicit flags are requested.
|
|
||||||
func (c *Converter) RegisterInputDefaults(in interface{}, fn FieldMappingFunc, defaultFlags FieldMatchingFlags) error {
|
|
||||||
fv := reflect.ValueOf(in)
|
|
||||||
ft := fv.Type()
|
|
||||||
if ft.Kind() != reflect.Ptr {
|
|
||||||
return fmt.Errorf("expected pointer 'in' argument, got: %v", ft)
|
|
||||||
}
|
|
||||||
c.inputFieldMappingFuncs[ft] = fn
|
|
||||||
c.inputDefaultFlags[ft] = defaultFlags
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// FieldMatchingFlags contains a list of ways in which struct fields could be
|
|
||||||
// copied. These constants may be | combined.
|
|
||||||
type FieldMatchingFlags int
|
|
||||||
|
|
||||||
const (
|
|
||||||
// Loop through destination fields, search for matching source
|
|
||||||
// field to copy it from. Source fields with no corresponding
|
|
||||||
// destination field will be ignored. If SourceToDest is
|
|
||||||
// specified, this flag is ignored. If neither is specified,
|
|
||||||
// or no flags are passed, this flag is the default.
|
|
||||||
DestFromSource FieldMatchingFlags = 0
|
|
||||||
// Loop through source fields, search for matching dest field
|
|
||||||
// to copy it into. Destination fields with no corresponding
|
|
||||||
// source field will be ignored.
|
|
||||||
SourceToDest FieldMatchingFlags = 1 << iota
|
|
||||||
// Don't treat it as an error if the corresponding source or
|
|
||||||
// dest field can't be found.
|
|
||||||
IgnoreMissingFields
|
|
||||||
// Don't require type names to match.
|
|
||||||
AllowDifferentFieldTypeNames
|
|
||||||
)
|
|
||||||
|
|
||||||
// IsSet returns true if the given flag or combination of flags is set.
|
|
||||||
func (f FieldMatchingFlags) IsSet(flag FieldMatchingFlags) bool {
|
|
||||||
if flag == DestFromSource {
|
|
||||||
// The bit logic doesn't work on the default value.
|
|
||||||
return f&SourceToDest != SourceToDest
|
|
||||||
}
|
|
||||||
return f&flag == flag
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert will translate src to dest if it knows how. Both must be pointers.
|
|
||||||
// If no conversion func is registered and the default copying mechanism
|
|
||||||
// doesn't work on this type pair, an error will be returned.
|
|
||||||
// Read the comments on the various FieldMatchingFlags constants to understand
|
|
||||||
// what the 'flags' parameter does.
|
|
||||||
// 'meta' is given to allow you to pass information to conversion functions,
|
|
||||||
// it is not used by Convert() other than storing it in the scope.
|
|
||||||
// Not safe for objects with cyclic references!
|
|
||||||
func (c *Converter) Convert(src, dest interface{}, flags FieldMatchingFlags, meta *Meta) error {
|
|
||||||
if len(c.genericConversions) > 0 {
|
|
||||||
// TODO: avoid scope allocation
|
|
||||||
s := &scope{converter: c, flags: flags, meta: meta}
|
|
||||||
for _, fn := range c.genericConversions {
|
|
||||||
if ok, err := fn(src, dest, s); ok {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return c.doConversion(src, dest, flags, meta, c.convert)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultConvert will translate src to dest if it knows how. Both must be pointers.
|
|
||||||
// No conversion func is used. If the default copying mechanism
|
|
||||||
// doesn't work on this type pair, an error will be returned.
|
|
||||||
// Read the comments on the various FieldMatchingFlags constants to understand
|
|
||||||
// what the 'flags' parameter does.
|
|
||||||
// 'meta' is given to allow you to pass information to conversion functions,
|
|
||||||
// it is not used by DefaultConvert() other than storing it in the scope.
|
|
||||||
// Not safe for objects with cyclic references!
|
|
||||||
func (c *Converter) DefaultConvert(src, dest interface{}, flags FieldMatchingFlags, meta *Meta) error {
|
|
||||||
return c.doConversion(src, dest, flags, meta, c.defaultConvert)
|
|
||||||
}
|
|
||||||
|
|
||||||
type conversionFunc func(sv, dv reflect.Value, scope *scope) error
|
|
||||||
|
|
||||||
func (c *Converter) doConversion(src, dest interface{}, flags FieldMatchingFlags, meta *Meta, f conversionFunc) error {
|
|
||||||
dv, err := EnforcePtr(dest)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if !dv.CanAddr() && !dv.CanSet() {
|
|
||||||
return fmt.Errorf("can't write to dest")
|
|
||||||
}
|
|
||||||
sv, err := EnforcePtr(src)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
s := &scope{
|
|
||||||
converter: c,
|
|
||||||
flags: flags,
|
|
||||||
meta: meta,
|
|
||||||
}
|
|
||||||
// Leave something on the stack, so that calls to struct tag getters never fail.
|
|
||||||
s.srcStack.push(scopeStackElem{})
|
|
||||||
s.destStack.push(scopeStackElem{})
|
|
||||||
return f(sv, dv, s)
|
|
||||||
}
|
|
||||||
|
|
||||||
// callCustom calls 'custom' with sv & dv. custom must be a conversion function.
|
|
||||||
func (c *Converter) callCustom(sv, dv, custom reflect.Value, scope *scope) error {
|
|
||||||
if !sv.CanAddr() {
|
|
||||||
sv2 := reflect.New(sv.Type())
|
|
||||||
sv2.Elem().Set(sv)
|
|
||||||
sv = sv2
|
|
||||||
} else {
|
|
||||||
sv = sv.Addr()
|
|
||||||
}
|
|
||||||
if !dv.CanAddr() {
|
|
||||||
if !dv.CanSet() {
|
|
||||||
return scope.errorf("can't addr or set dest.")
|
|
||||||
}
|
|
||||||
dvOrig := dv
|
|
||||||
dv := reflect.New(dvOrig.Type())
|
|
||||||
defer func() { dvOrig.Set(dv) }()
|
|
||||||
} else {
|
|
||||||
dv = dv.Addr()
|
|
||||||
}
|
|
||||||
args := []reflect.Value{sv, dv, reflect.ValueOf(scope)}
|
|
||||||
ret := custom.Call(args)[0].Interface()
|
|
||||||
// This convolution is necessary because nil interfaces won't convert
|
|
||||||
// to errors.
|
|
||||||
if ret == nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return ret.(error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// convert recursively copies sv into dv, calling an appropriate conversion function if
|
|
||||||
// one is registered.
|
|
||||||
func (c *Converter) convert(sv, dv reflect.Value, scope *scope) error {
|
|
||||||
dt, st := dv.Type(), sv.Type()
|
|
||||||
// Apply default values.
|
|
||||||
if fv, ok := c.defaultingFuncs[st]; ok {
|
|
||||||
if c.Debug != nil {
|
|
||||||
c.Debug.Logf("Applying defaults for '%v'", st)
|
|
||||||
}
|
|
||||||
args := []reflect.Value{sv.Addr()}
|
|
||||||
fv.Call(args)
|
|
||||||
}
|
|
||||||
|
|
||||||
pair := typePair{st, dt}
|
|
||||||
|
|
||||||
// ignore conversions of this type
|
|
||||||
if _, ok := c.ignoredConversions[pair]; ok {
|
|
||||||
if c.Debug != nil {
|
|
||||||
c.Debug.Logf("Ignoring conversion of '%v' to '%v'", st, dt)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert sv to dv.
|
|
||||||
if fv, ok := c.conversionFuncs.fns[pair]; ok {
|
|
||||||
if c.Debug != nil {
|
|
||||||
c.Debug.Logf("Calling custom conversion of '%v' to '%v'", st, dt)
|
|
||||||
}
|
|
||||||
return c.callCustom(sv, dv, fv, scope)
|
|
||||||
}
|
|
||||||
if fv, ok := c.generatedConversionFuncs.fns[pair]; ok {
|
|
||||||
if c.Debug != nil {
|
|
||||||
c.Debug.Logf("Calling generated conversion of '%v' to '%v'", st, dt)
|
|
||||||
}
|
|
||||||
return c.callCustom(sv, dv, fv, scope)
|
|
||||||
}
|
|
||||||
|
|
||||||
return c.defaultConvert(sv, dv, scope)
|
|
||||||
}
|
|
||||||
|
|
||||||
// defaultConvert recursively copies sv into dv. no conversion function is called
|
|
||||||
// for the current stack frame (but conversion functions may be called for nested objects)
|
|
||||||
func (c *Converter) defaultConvert(sv, dv reflect.Value, scope *scope) error {
|
|
||||||
dt, st := dv.Type(), sv.Type()
|
|
||||||
|
|
||||||
if !dv.CanSet() {
|
|
||||||
return scope.errorf("Cannot set dest. (Tried to deep copy something with unexported fields?)")
|
|
||||||
}
|
|
||||||
|
|
||||||
if !scope.flags.IsSet(AllowDifferentFieldTypeNames) && c.nameFunc(dt) != c.nameFunc(st) {
|
|
||||||
return scope.errorf(
|
|
||||||
"type names don't match (%v, %v), and no conversion 'func (%v, %v) error' registered.",
|
|
||||||
c.nameFunc(st), c.nameFunc(dt), st, dt)
|
|
||||||
}
|
|
||||||
|
|
||||||
switch st.Kind() {
|
|
||||||
case reflect.Map, reflect.Ptr, reflect.Slice, reflect.Interface, reflect.Struct:
|
|
||||||
// Don't copy these via assignment/conversion!
|
|
||||||
default:
|
|
||||||
// This should handle all simple types.
|
|
||||||
if st.AssignableTo(dt) {
|
|
||||||
dv.Set(sv)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if st.ConvertibleTo(dt) {
|
|
||||||
dv.Set(sv.Convert(dt))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if c.Debug != nil {
|
|
||||||
c.Debug.Logf("Trying to convert '%v' to '%v'", st, dt)
|
|
||||||
}
|
|
||||||
|
|
||||||
scope.srcStack.push(scopeStackElem{value: sv})
|
|
||||||
scope.destStack.push(scopeStackElem{value: dv})
|
|
||||||
defer scope.srcStack.pop()
|
|
||||||
defer scope.destStack.pop()
|
|
||||||
|
|
||||||
switch dv.Kind() {
|
|
||||||
case reflect.Struct:
|
|
||||||
return c.convertKV(toKVValue(sv), toKVValue(dv), scope)
|
|
||||||
case reflect.Slice:
|
|
||||||
if sv.IsNil() {
|
|
||||||
// Don't make a zero-length slice.
|
|
||||||
dv.Set(reflect.Zero(dt))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
dv.Set(reflect.MakeSlice(dt, sv.Len(), sv.Cap()))
|
|
||||||
for i := 0; i < sv.Len(); i++ {
|
|
||||||
scope.setIndices(i, i)
|
|
||||||
if err := c.convert(sv.Index(i), dv.Index(i), scope); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
case reflect.Ptr:
|
|
||||||
if sv.IsNil() {
|
|
||||||
// Don't copy a nil ptr!
|
|
||||||
dv.Set(reflect.Zero(dt))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
dv.Set(reflect.New(dt.Elem()))
|
|
||||||
switch st.Kind() {
|
|
||||||
case reflect.Ptr, reflect.Interface:
|
|
||||||
return c.convert(sv.Elem(), dv.Elem(), scope)
|
|
||||||
default:
|
|
||||||
return c.convert(sv, dv.Elem(), scope)
|
|
||||||
}
|
|
||||||
case reflect.Map:
|
|
||||||
if sv.IsNil() {
|
|
||||||
// Don't copy a nil ptr!
|
|
||||||
dv.Set(reflect.Zero(dt))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
dv.Set(reflect.MakeMap(dt))
|
|
||||||
for _, sk := range sv.MapKeys() {
|
|
||||||
dk := reflect.New(dt.Key()).Elem()
|
|
||||||
if err := c.convert(sk, dk, scope); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
dkv := reflect.New(dt.Elem()).Elem()
|
|
||||||
scope.setKeys(sk.Interface(), dk.Interface())
|
|
||||||
// TODO: sv.MapIndex(sk) may return a value with CanAddr() == false,
|
|
||||||
// because a map[string]struct{} does not allow a pointer reference.
|
|
||||||
// Calling a custom conversion function defined for the map value
|
|
||||||
// will panic. Example is PodInfo map[string]ContainerStatus.
|
|
||||||
if err := c.convert(sv.MapIndex(sk), dkv, scope); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
dv.SetMapIndex(dk, dkv)
|
|
||||||
}
|
|
||||||
case reflect.Interface:
|
|
||||||
if sv.IsNil() {
|
|
||||||
// Don't copy a nil interface!
|
|
||||||
dv.Set(reflect.Zero(dt))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
tmpdv := reflect.New(sv.Elem().Type()).Elem()
|
|
||||||
if err := c.convert(sv.Elem(), tmpdv, scope); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
dv.Set(reflect.ValueOf(tmpdv.Interface()))
|
|
||||||
return nil
|
|
||||||
default:
|
|
||||||
return scope.errorf("couldn't copy '%v' into '%v'; didn't understand types", st, dt)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
var stringType = reflect.TypeOf("")
|
|
||||||
|
|
||||||
func toKVValue(v reflect.Value) kvValue {
|
|
||||||
switch v.Kind() {
|
|
||||||
case reflect.Struct:
|
|
||||||
return structAdaptor(v)
|
|
||||||
case reflect.Map:
|
|
||||||
if v.Type().Key().AssignableTo(stringType) {
|
|
||||||
return stringMapAdaptor(v)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// kvValue lets us write the same conversion logic to work with both maps
|
|
||||||
// and structs. Only maps with string keys make sense for this.
|
|
||||||
type kvValue interface {
|
|
||||||
// returns all keys, as a []string.
|
|
||||||
keys() []string
|
|
||||||
// Will just return "" for maps.
|
|
||||||
tagOf(key string) reflect.StructTag
|
|
||||||
// Will return the zero Value if the key doesn't exist.
|
|
||||||
value(key string) reflect.Value
|
|
||||||
// Maps require explicit setting-- will do nothing for structs.
|
|
||||||
// Returns false on failure.
|
|
||||||
confirmSet(key string, v reflect.Value) bool
|
|
||||||
}
|
|
||||||
|
|
||||||
type stringMapAdaptor reflect.Value
|
|
||||||
|
|
||||||
func (a stringMapAdaptor) len() int {
|
|
||||||
return reflect.Value(a).Len()
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a stringMapAdaptor) keys() []string {
|
|
||||||
v := reflect.Value(a)
|
|
||||||
keys := make([]string, v.Len())
|
|
||||||
for i, v := range v.MapKeys() {
|
|
||||||
if v.IsNil() {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
switch t := v.Interface().(type) {
|
|
||||||
case string:
|
|
||||||
keys[i] = t
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return keys
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a stringMapAdaptor) tagOf(key string) reflect.StructTag {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a stringMapAdaptor) value(key string) reflect.Value {
|
|
||||||
return reflect.Value(a).MapIndex(reflect.ValueOf(key))
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a stringMapAdaptor) confirmSet(key string, v reflect.Value) bool {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
type structAdaptor reflect.Value
|
|
||||||
|
|
||||||
func (a structAdaptor) len() int {
|
|
||||||
v := reflect.Value(a)
|
|
||||||
return v.Type().NumField()
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a structAdaptor) keys() []string {
|
|
||||||
v := reflect.Value(a)
|
|
||||||
t := v.Type()
|
|
||||||
keys := make([]string, t.NumField())
|
|
||||||
for i := range keys {
|
|
||||||
keys[i] = t.Field(i).Name
|
|
||||||
}
|
|
||||||
return keys
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a structAdaptor) tagOf(key string) reflect.StructTag {
|
|
||||||
v := reflect.Value(a)
|
|
||||||
field, ok := v.Type().FieldByName(key)
|
|
||||||
if ok {
|
|
||||||
return field.Tag
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a structAdaptor) value(key string) reflect.Value {
|
|
||||||
v := reflect.Value(a)
|
|
||||||
return v.FieldByName(key)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (a structAdaptor) confirmSet(key string, v reflect.Value) bool {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// convertKV can convert things that consist of key/value pairs, like structs
|
|
||||||
// and some maps.
|
|
||||||
func (c *Converter) convertKV(skv, dkv kvValue, scope *scope) error {
|
|
||||||
if skv == nil || dkv == nil {
|
|
||||||
// TODO: add keys to stack to support really understandable error messages.
|
|
||||||
return fmt.Errorf("Unable to convert %#v to %#v", skv, dkv)
|
|
||||||
}
|
|
||||||
|
|
||||||
lister := dkv
|
|
||||||
if scope.flags.IsSet(SourceToDest) {
|
|
||||||
lister = skv
|
|
||||||
}
|
|
||||||
|
|
||||||
var mapping FieldMappingFunc
|
|
||||||
if scope.meta != nil && scope.meta.KeyNameMapping != nil {
|
|
||||||
mapping = scope.meta.KeyNameMapping
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, key := range lister.keys() {
|
|
||||||
if found, err := c.checkField(key, skv, dkv, scope); found {
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
stag := skv.tagOf(key)
|
|
||||||
dtag := dkv.tagOf(key)
|
|
||||||
skey := key
|
|
||||||
dkey := key
|
|
||||||
if mapping != nil {
|
|
||||||
skey, dkey = scope.meta.KeyNameMapping(key, stag, dtag)
|
|
||||||
}
|
|
||||||
|
|
||||||
df := dkv.value(dkey)
|
|
||||||
sf := skv.value(skey)
|
|
||||||
if !df.IsValid() || !sf.IsValid() {
|
|
||||||
switch {
|
|
||||||
case scope.flags.IsSet(IgnoreMissingFields):
|
|
||||||
// No error.
|
|
||||||
case scope.flags.IsSet(SourceToDest):
|
|
||||||
return scope.errorf("%v not present in dest", dkey)
|
|
||||||
default:
|
|
||||||
return scope.errorf("%v not present in src", skey)
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
scope.srcStack.top().key = skey
|
|
||||||
scope.srcStack.top().tag = stag
|
|
||||||
scope.destStack.top().key = dkey
|
|
||||||
scope.destStack.top().tag = dtag
|
|
||||||
if err := c.convert(sf, df, scope); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// checkField returns true if the field name matches any of the struct
|
|
||||||
// field copying rules. The error should be ignored if it returns false.
|
|
||||||
func (c *Converter) checkField(fieldName string, skv, dkv kvValue, scope *scope) (bool, error) {
|
|
||||||
replacementMade := false
|
|
||||||
if scope.flags.IsSet(DestFromSource) {
|
|
||||||
df := dkv.value(fieldName)
|
|
||||||
if !df.IsValid() {
|
|
||||||
return false, nil
|
|
||||||
}
|
|
||||||
destKey := typeNamePair{df.Type(), fieldName}
|
|
||||||
// Check each of the potential source (type, name) pairs to see if they're
|
|
||||||
// present in sv.
|
|
||||||
for _, potentialSourceKey := range c.structFieldSources[destKey] {
|
|
||||||
sf := skv.value(potentialSourceKey.fieldName)
|
|
||||||
if !sf.IsValid() {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if sf.Type() == potentialSourceKey.fieldType {
|
|
||||||
// Both the source's name and type matched, so copy.
|
|
||||||
scope.srcStack.top().key = potentialSourceKey.fieldName
|
|
||||||
scope.destStack.top().key = fieldName
|
|
||||||
if err := c.convert(sf, df, scope); err != nil {
|
|
||||||
return true, err
|
|
||||||
}
|
|
||||||
dkv.confirmSet(fieldName, df)
|
|
||||||
replacementMade = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return replacementMade, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
sf := skv.value(fieldName)
|
|
||||||
if !sf.IsValid() {
|
|
||||||
return false, nil
|
|
||||||
}
|
|
||||||
srcKey := typeNamePair{sf.Type(), fieldName}
|
|
||||||
// Check each of the potential dest (type, name) pairs to see if they're
|
|
||||||
// present in dv.
|
|
||||||
for _, potentialDestKey := range c.structFieldDests[srcKey] {
|
|
||||||
df := dkv.value(potentialDestKey.fieldName)
|
|
||||||
if !df.IsValid() {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if df.Type() == potentialDestKey.fieldType {
|
|
||||||
// Both the dest's name and type matched, so copy.
|
|
||||||
scope.srcStack.top().key = fieldName
|
|
||||||
scope.destStack.top().key = potentialDestKey.fieldName
|
|
||||||
if err := c.convert(sf, df, scope); err != nil {
|
|
||||||
return true, err
|
|
||||||
}
|
|
||||||
dkv.confirmSet(potentialDestKey.fieldName, df)
|
|
||||||
replacementMade = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return replacementMade, nil
|
|
||||||
}
|
|
||||||
@@ -1,36 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 conversion
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/third_party/forked/golang/reflect"
|
|
||||||
)
|
|
||||||
|
|
||||||
// The code for this type must be located in third_party, since it forks from
|
|
||||||
// go std lib. But for convenience, we expose the type here, too.
|
|
||||||
type Equalities struct {
|
|
||||||
reflect.Equalities
|
|
||||||
}
|
|
||||||
|
|
||||||
// For convenience, panics on errors
|
|
||||||
func EqualitiesOrDie(funcs ...interface{}) Equalities {
|
|
||||||
e := Equalities{reflect.Equalities{}}
|
|
||||||
if err := e.AddFuncs(funcs...); err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return e
|
|
||||||
}
|
|
||||||
@@ -1,24 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 conversion provides go object versioning.
|
|
||||||
//
|
|
||||||
// Specifically, conversion provides a way for you to define multiple versions
|
|
||||||
// of the same object. You may write functions which implement conversion logic,
|
|
||||||
// but for the fields which did not change, copying is automated. This makes it
|
|
||||||
// easy to modify the structures you use in memory without affecting the format
|
|
||||||
// you store on disk or respond to in your external API calls.
|
|
||||||
package conversion
|
|
||||||
@@ -1,39 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 conversion
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
)
|
|
||||||
|
|
||||||
// EnforcePtr ensures that obj is a pointer of some sort. Returns a reflect.Value
|
|
||||||
// of the dereferenced pointer, ensuring that it is settable/addressable.
|
|
||||||
// Returns an error if this is not possible.
|
|
||||||
func EnforcePtr(obj interface{}) (reflect.Value, error) {
|
|
||||||
v := reflect.ValueOf(obj)
|
|
||||||
if v.Kind() != reflect.Ptr {
|
|
||||||
if v.Kind() == reflect.Invalid {
|
|
||||||
return reflect.Value{}, fmt.Errorf("expected pointer, but got invalid kind")
|
|
||||||
}
|
|
||||||
return reflect.Value{}, fmt.Errorf("expected pointer, but got %v type", v.Type())
|
|
||||||
}
|
|
||||||
if v.IsNil() {
|
|
||||||
return reflect.Value{}, fmt.Errorf("expected pointer, but got nil")
|
|
||||||
}
|
|
||||||
return v.Elem(), nil
|
|
||||||
}
|
|
||||||
@@ -1,188 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 queryparams
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/url"
|
|
||||||
"reflect"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Marshaler converts an object to a query parameter string representation
|
|
||||||
type Marshaler interface {
|
|
||||||
MarshalQueryParameter() (string, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unmarshaler converts a string representation to an object
|
|
||||||
type Unmarshaler interface {
|
|
||||||
UnmarshalQueryParameter(string) error
|
|
||||||
}
|
|
||||||
|
|
||||||
func jsonTag(field reflect.StructField) (string, bool) {
|
|
||||||
structTag := field.Tag.Get("json")
|
|
||||||
if len(structTag) == 0 {
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
parts := strings.Split(structTag, ",")
|
|
||||||
tag := parts[0]
|
|
||||||
if tag == "-" {
|
|
||||||
tag = ""
|
|
||||||
}
|
|
||||||
omitempty := false
|
|
||||||
parts = parts[1:]
|
|
||||||
for _, part := range parts {
|
|
||||||
if part == "omitempty" {
|
|
||||||
omitempty = true
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return tag, omitempty
|
|
||||||
}
|
|
||||||
|
|
||||||
func formatValue(value interface{}) string {
|
|
||||||
return fmt.Sprintf("%v", value)
|
|
||||||
}
|
|
||||||
|
|
||||||
func isPointerKind(kind reflect.Kind) bool {
|
|
||||||
return kind == reflect.Ptr
|
|
||||||
}
|
|
||||||
|
|
||||||
func isStructKind(kind reflect.Kind) bool {
|
|
||||||
return kind == reflect.Struct
|
|
||||||
}
|
|
||||||
|
|
||||||
func isValueKind(kind reflect.Kind) bool {
|
|
||||||
switch kind {
|
|
||||||
case reflect.String, reflect.Bool, reflect.Int, reflect.Int8, reflect.Int16,
|
|
||||||
reflect.Int32, reflect.Int64, reflect.Uint, reflect.Uint8,
|
|
||||||
reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Float32,
|
|
||||||
reflect.Float64, reflect.Complex64, reflect.Complex128:
|
|
||||||
return true
|
|
||||||
default:
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func zeroValue(value reflect.Value) bool {
|
|
||||||
return reflect.DeepEqual(reflect.Zero(value.Type()).Interface(), value.Interface())
|
|
||||||
}
|
|
||||||
|
|
||||||
func customMarshalValue(value reflect.Value) (reflect.Value, bool) {
|
|
||||||
// Return unless we implement a custom query marshaler
|
|
||||||
if !value.CanInterface() {
|
|
||||||
return reflect.Value{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
marshaler, ok := value.Interface().(Marshaler)
|
|
||||||
if !ok {
|
|
||||||
return reflect.Value{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Don't invoke functions on nil pointers
|
|
||||||
// If the type implements MarshalQueryParameter, AND the tag is not omitempty, AND the value is a nil pointer, "" seems like a reasonable response
|
|
||||||
if isPointerKind(value.Kind()) && zeroValue(value) {
|
|
||||||
return reflect.ValueOf(""), true
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get the custom marshalled value
|
|
||||||
v, err := marshaler.MarshalQueryParameter()
|
|
||||||
if err != nil {
|
|
||||||
return reflect.Value{}, false
|
|
||||||
}
|
|
||||||
return reflect.ValueOf(v), true
|
|
||||||
}
|
|
||||||
|
|
||||||
func addParam(values url.Values, tag string, omitempty bool, value reflect.Value) {
|
|
||||||
if omitempty && zeroValue(value) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
val := ""
|
|
||||||
iValue := fmt.Sprintf("%v", value.Interface())
|
|
||||||
|
|
||||||
if iValue != "<nil>" {
|
|
||||||
val = iValue
|
|
||||||
}
|
|
||||||
values.Add(tag, val)
|
|
||||||
}
|
|
||||||
|
|
||||||
func addListOfParams(values url.Values, tag string, omitempty bool, list reflect.Value) {
|
|
||||||
for i := 0; i < list.Len(); i++ {
|
|
||||||
addParam(values, tag, omitempty, list.Index(i))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert takes an object and converts it to a url.Values object using JSON tags as
|
|
||||||
// parameter names. Only top-level simple values, arrays, and slices are serialized.
|
|
||||||
// Embedded structs, maps, etc. will not be serialized.
|
|
||||||
func Convert(obj interface{}) (url.Values, error) {
|
|
||||||
result := url.Values{}
|
|
||||||
if obj == nil {
|
|
||||||
return result, nil
|
|
||||||
}
|
|
||||||
var sv reflect.Value
|
|
||||||
switch reflect.TypeOf(obj).Kind() {
|
|
||||||
case reflect.Ptr, reflect.Interface:
|
|
||||||
sv = reflect.ValueOf(obj).Elem()
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("expecting a pointer or interface")
|
|
||||||
}
|
|
||||||
st := sv.Type()
|
|
||||||
if !isStructKind(st.Kind()) {
|
|
||||||
return nil, fmt.Errorf("expecting a pointer to a struct")
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check all object fields
|
|
||||||
convertStruct(result, st, sv)
|
|
||||||
|
|
||||||
return result, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func convertStruct(result url.Values, st reflect.Type, sv reflect.Value) {
|
|
||||||
for i := 0; i < st.NumField(); i++ {
|
|
||||||
field := sv.Field(i)
|
|
||||||
tag, omitempty := jsonTag(st.Field(i))
|
|
||||||
if len(tag) == 0 {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
ft := field.Type()
|
|
||||||
|
|
||||||
kind := ft.Kind()
|
|
||||||
if isPointerKind(kind) {
|
|
||||||
ft = ft.Elem()
|
|
||||||
kind = ft.Kind()
|
|
||||||
if !field.IsNil() {
|
|
||||||
field = reflect.Indirect(field)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
switch {
|
|
||||||
case isValueKind(kind):
|
|
||||||
addParam(result, tag, omitempty, field)
|
|
||||||
case kind == reflect.Array || kind == reflect.Slice:
|
|
||||||
if isValueKind(ft.Elem().Kind()) {
|
|
||||||
addListOfParams(result, tag, omitempty, field)
|
|
||||||
}
|
|
||||||
case isStructKind(kind) && !(zeroValue(field) && omitempty):
|
|
||||||
if marshalValue, ok := customMarshalValue(field); ok {
|
|
||||||
addParam(result, tag, omitempty, marshalValue)
|
|
||||||
} else {
|
|
||||||
convertStruct(result, ft, field)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 queryparams provides conversion from versioned
|
|
||||||
// runtime objects to URL query values
|
|
||||||
package queryparams
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 fields implements a simple field system, parsing and matching
|
|
||||||
// selectors with sets of fields.
|
|
||||||
package fields
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 fields
|
|
||||||
|
|
||||||
import (
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Fields allows you to present fields independently from their storage.
|
|
||||||
type Fields interface {
|
|
||||||
// Has returns whether the provided field exists.
|
|
||||||
Has(field string) (exists bool)
|
|
||||||
|
|
||||||
// Get returns the value for the provided field.
|
|
||||||
Get(field string) (value string)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Set is a map of field:value. It implements Fields.
|
|
||||||
type Set map[string]string
|
|
||||||
|
|
||||||
// String returns all fields listed as a human readable string.
|
|
||||||
// Conveniently, exactly the format that ParseSelector takes.
|
|
||||||
func (ls Set) String() string {
|
|
||||||
selector := make([]string, 0, len(ls))
|
|
||||||
for key, value := range ls {
|
|
||||||
selector = append(selector, key+"="+value)
|
|
||||||
}
|
|
||||||
// Sort for determinism.
|
|
||||||
sort.StringSlice(selector).Sort()
|
|
||||||
return strings.Join(selector, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// Has returns whether the provided field exists in the map.
|
|
||||||
func (ls Set) Has(field string) bool {
|
|
||||||
_, exists := ls[field]
|
|
||||||
return exists
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get returns the value in the map for the provided field.
|
|
||||||
func (ls Set) Get(field string) string {
|
|
||||||
return ls[field]
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsSelector converts fields into a selectors.
|
|
||||||
func (ls Set) AsSelector() Selector {
|
|
||||||
return SelectorFromSet(ls)
|
|
||||||
}
|
|
||||||
@@ -1,30 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 fields
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/selection"
|
|
||||||
|
|
||||||
// Requirements is AND of all requirements.
|
|
||||||
type Requirements []Requirement
|
|
||||||
|
|
||||||
// Requirement contains a field, a value, and an operator that relates the field and value.
|
|
||||||
// This is currently for reading internal selection information of field selector.
|
|
||||||
type Requirement struct {
|
|
||||||
Operator selection.Operator
|
|
||||||
Field string
|
|
||||||
Value string
|
|
||||||
}
|
|
||||||
@@ -1,413 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 fields
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"fmt"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/selection"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Selector represents a field selector.
|
|
||||||
type Selector interface {
|
|
||||||
// Matches returns true if this selector matches the given set of fields.
|
|
||||||
Matches(Fields) bool
|
|
||||||
|
|
||||||
// Empty returns true if this selector does not restrict the selection space.
|
|
||||||
Empty() bool
|
|
||||||
|
|
||||||
// RequiresExactMatch allows a caller to introspect whether a given selector
|
|
||||||
// requires a single specific field to be set, and if so returns the value it
|
|
||||||
// requires.
|
|
||||||
RequiresExactMatch(field string) (value string, found bool)
|
|
||||||
|
|
||||||
// Transform returns a new copy of the selector after TransformFunc has been
|
|
||||||
// applied to the entire selector, or an error if fn returns an error.
|
|
||||||
Transform(fn TransformFunc) (Selector, error)
|
|
||||||
|
|
||||||
// Requirements converts this interface to Requirements to expose
|
|
||||||
// more detailed selection information.
|
|
||||||
Requirements() Requirements
|
|
||||||
|
|
||||||
// String returns a human readable string that represents this selector.
|
|
||||||
String() string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Everything returns a selector that matches all fields.
|
|
||||||
func Everything() Selector {
|
|
||||||
return andTerm{}
|
|
||||||
}
|
|
||||||
|
|
||||||
type hasTerm struct {
|
|
||||||
field, value string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) Matches(ls Fields) bool {
|
|
||||||
return ls.Get(t.field) == t.value
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) Empty() bool {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) RequiresExactMatch(field string) (value string, found bool) {
|
|
||||||
if t.field == field {
|
|
||||||
return t.value, true
|
|
||||||
}
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) Transform(fn TransformFunc) (Selector, error) {
|
|
||||||
field, value, err := fn(t.field, t.value)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return &hasTerm{field, value}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) Requirements() Requirements {
|
|
||||||
return []Requirement{{
|
|
||||||
Field: t.field,
|
|
||||||
Operator: selection.Equals,
|
|
||||||
Value: t.value,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *hasTerm) String() string {
|
|
||||||
return fmt.Sprintf("%v=%v", t.field, EscapeValue(t.value))
|
|
||||||
}
|
|
||||||
|
|
||||||
type notHasTerm struct {
|
|
||||||
field, value string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) Matches(ls Fields) bool {
|
|
||||||
return ls.Get(t.field) != t.value
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) Empty() bool {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) RequiresExactMatch(field string) (value string, found bool) {
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) Transform(fn TransformFunc) (Selector, error) {
|
|
||||||
field, value, err := fn(t.field, t.value)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return ¬HasTerm{field, value}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) Requirements() Requirements {
|
|
||||||
return []Requirement{{
|
|
||||||
Field: t.field,
|
|
||||||
Operator: selection.NotEquals,
|
|
||||||
Value: t.value,
|
|
||||||
}}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t *notHasTerm) String() string {
|
|
||||||
return fmt.Sprintf("%v!=%v", t.field, EscapeValue(t.value))
|
|
||||||
}
|
|
||||||
|
|
||||||
type andTerm []Selector
|
|
||||||
|
|
||||||
func (t andTerm) Matches(ls Fields) bool {
|
|
||||||
for _, q := range t {
|
|
||||||
if !q.Matches(ls) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t andTerm) Empty() bool {
|
|
||||||
if t == nil {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
if len([]Selector(t)) == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
for i := range t {
|
|
||||||
if !t[i].Empty() {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t andTerm) RequiresExactMatch(field string) (string, bool) {
|
|
||||||
if t == nil || len([]Selector(t)) == 0 {
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
for i := range t {
|
|
||||||
if value, found := t[i].RequiresExactMatch(field); found {
|
|
||||||
return value, found
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return "", false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t andTerm) Transform(fn TransformFunc) (Selector, error) {
|
|
||||||
next := make([]Selector, len([]Selector(t)))
|
|
||||||
for i, s := range []Selector(t) {
|
|
||||||
n, err := s.Transform(fn)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
next[i] = n
|
|
||||||
}
|
|
||||||
return andTerm(next), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t andTerm) Requirements() Requirements {
|
|
||||||
reqs := make([]Requirement, 0, len(t))
|
|
||||||
for _, s := range []Selector(t) {
|
|
||||||
rs := s.Requirements()
|
|
||||||
reqs = append(reqs, rs...)
|
|
||||||
}
|
|
||||||
return reqs
|
|
||||||
}
|
|
||||||
|
|
||||||
func (t andTerm) String() string {
|
|
||||||
var terms []string
|
|
||||||
for _, q := range t {
|
|
||||||
terms = append(terms, q.String())
|
|
||||||
}
|
|
||||||
return strings.Join(terms, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// SelectorFromSet returns a Selector which will match exactly the given Set. A
|
|
||||||
// nil Set is considered equivalent to Everything().
|
|
||||||
func SelectorFromSet(ls Set) Selector {
|
|
||||||
if ls == nil {
|
|
||||||
return Everything()
|
|
||||||
}
|
|
||||||
items := make([]Selector, 0, len(ls))
|
|
||||||
for field, value := range ls {
|
|
||||||
items = append(items, &hasTerm{field: field, value: value})
|
|
||||||
}
|
|
||||||
if len(items) == 1 {
|
|
||||||
return items[0]
|
|
||||||
}
|
|
||||||
return andTerm(items)
|
|
||||||
}
|
|
||||||
|
|
||||||
// valueEscaper prefixes \,= characters with a backslash
|
|
||||||
var valueEscaper = strings.NewReplacer(
|
|
||||||
// escape \ characters
|
|
||||||
`\`, `\\`,
|
|
||||||
// then escape , and = characters to allow unambiguous parsing of the value in a fieldSelector
|
|
||||||
`,`, `\,`,
|
|
||||||
`=`, `\=`,
|
|
||||||
)
|
|
||||||
|
|
||||||
// Escapes an arbitrary literal string for use as a fieldSelector value
|
|
||||||
func EscapeValue(s string) string {
|
|
||||||
return valueEscaper.Replace(s)
|
|
||||||
}
|
|
||||||
|
|
||||||
// InvalidEscapeSequence indicates an error occurred unescaping a field selector
|
|
||||||
type InvalidEscapeSequence struct {
|
|
||||||
sequence string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (i InvalidEscapeSequence) Error() string {
|
|
||||||
return fmt.Sprintf("invalid field selector: invalid escape sequence: %s", i.sequence)
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnescapedRune indicates an error occurred unescaping a field selector
|
|
||||||
type UnescapedRune struct {
|
|
||||||
r rune
|
|
||||||
}
|
|
||||||
|
|
||||||
func (i UnescapedRune) Error() string {
|
|
||||||
return fmt.Sprintf("invalid field selector: unescaped character in value: %v", i.r)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unescapes a fieldSelector value and returns the original literal value.
|
|
||||||
// May return the original string if it contains no escaped or special characters.
|
|
||||||
func UnescapeValue(s string) (string, error) {
|
|
||||||
// if there's no escaping or special characters, just return to avoid allocation
|
|
||||||
if !strings.ContainsAny(s, `\,=`) {
|
|
||||||
return s, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
v := bytes.NewBuffer(make([]byte, 0, len(s)))
|
|
||||||
inSlash := false
|
|
||||||
for _, c := range s {
|
|
||||||
if inSlash {
|
|
||||||
switch c {
|
|
||||||
case '\\', ',', '=':
|
|
||||||
// omit the \ for recognized escape sequences
|
|
||||||
v.WriteRune(c)
|
|
||||||
default:
|
|
||||||
// error on unrecognized escape sequences
|
|
||||||
return "", InvalidEscapeSequence{sequence: string([]rune{'\\', c})}
|
|
||||||
}
|
|
||||||
inSlash = false
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
switch c {
|
|
||||||
case '\\':
|
|
||||||
inSlash = true
|
|
||||||
case ',', '=':
|
|
||||||
// unescaped , and = characters are not allowed in field selector values
|
|
||||||
return "", UnescapedRune{r: c}
|
|
||||||
default:
|
|
||||||
v.WriteRune(c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Ending with a single backslash is an invalid sequence
|
|
||||||
if inSlash {
|
|
||||||
return "", InvalidEscapeSequence{sequence: "\\"}
|
|
||||||
}
|
|
||||||
|
|
||||||
return v.String(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseSelectorOrDie takes a string representing a selector and returns an
|
|
||||||
// object suitable for matching, or panic when an error occur.
|
|
||||||
func ParseSelectorOrDie(s string) Selector {
|
|
||||||
selector, err := ParseSelector(s)
|
|
||||||
if err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return selector
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseSelector takes a string representing a selector and returns an
|
|
||||||
// object suitable for matching, or an error.
|
|
||||||
func ParseSelector(selector string) (Selector, error) {
|
|
||||||
return parseSelector(selector,
|
|
||||||
func(lhs, rhs string) (newLhs, newRhs string, err error) {
|
|
||||||
return lhs, rhs, nil
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// Parses the selector and runs them through the given TransformFunc.
|
|
||||||
func ParseAndTransformSelector(selector string, fn TransformFunc) (Selector, error) {
|
|
||||||
return parseSelector(selector, fn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Function to transform selectors.
|
|
||||||
type TransformFunc func(field, value string) (newField, newValue string, err error)
|
|
||||||
|
|
||||||
// splitTerms returns the comma-separated terms contained in the given fieldSelector.
|
|
||||||
// Backslash-escaped commas are treated as data instead of delimiters, and are included in the returned terms, with the leading backslash preserved.
|
|
||||||
func splitTerms(fieldSelector string) []string {
|
|
||||||
if len(fieldSelector) == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
terms := make([]string, 0, 1)
|
|
||||||
startIndex := 0
|
|
||||||
inSlash := false
|
|
||||||
for i, c := range fieldSelector {
|
|
||||||
switch {
|
|
||||||
case inSlash:
|
|
||||||
inSlash = false
|
|
||||||
case c == '\\':
|
|
||||||
inSlash = true
|
|
||||||
case c == ',':
|
|
||||||
terms = append(terms, fieldSelector[startIndex:i])
|
|
||||||
startIndex = i + 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
terms = append(terms, fieldSelector[startIndex:])
|
|
||||||
|
|
||||||
return terms
|
|
||||||
}
|
|
||||||
|
|
||||||
const (
|
|
||||||
notEqualOperator = "!="
|
|
||||||
doubleEqualOperator = "=="
|
|
||||||
equalOperator = "="
|
|
||||||
)
|
|
||||||
|
|
||||||
// termOperators holds the recognized operators supported in fieldSelectors.
|
|
||||||
// doubleEqualOperator and equal are equivalent, but doubleEqualOperator is checked first
|
|
||||||
// to avoid leaving a leading = character on the rhs value.
|
|
||||||
var termOperators = []string{notEqualOperator, doubleEqualOperator, equalOperator}
|
|
||||||
|
|
||||||
// splitTerm returns the lhs, operator, and rhs parsed from the given term, along with an indicator of whether the parse was successful.
|
|
||||||
// no escaping of special characters is supported in the lhs value, so the first occurance of a recognized operator is used as the split point.
|
|
||||||
// the literal rhs is returned, and the caller is responsible for applying any desired unescaping.
|
|
||||||
func splitTerm(term string) (lhs, op, rhs string, ok bool) {
|
|
||||||
for i := range term {
|
|
||||||
remaining := term[i:]
|
|
||||||
for _, op := range termOperators {
|
|
||||||
if strings.HasPrefix(remaining, op) {
|
|
||||||
return term[0:i], op, term[i+len(op):], true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return "", "", "", false
|
|
||||||
}
|
|
||||||
|
|
||||||
func parseSelector(selector string, fn TransformFunc) (Selector, error) {
|
|
||||||
parts := splitTerms(selector)
|
|
||||||
sort.StringSlice(parts).Sort()
|
|
||||||
var items []Selector
|
|
||||||
for _, part := range parts {
|
|
||||||
if part == "" {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
lhs, op, rhs, ok := splitTerm(part)
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("invalid selector: '%s'; can't understand '%s'", selector, part)
|
|
||||||
}
|
|
||||||
unescapedRHS, err := UnescapeValue(rhs)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
switch op {
|
|
||||||
case notEqualOperator:
|
|
||||||
items = append(items, ¬HasTerm{field: lhs, value: unescapedRHS})
|
|
||||||
case doubleEqualOperator:
|
|
||||||
items = append(items, &hasTerm{field: lhs, value: unescapedRHS})
|
|
||||||
case equalOperator:
|
|
||||||
items = append(items, &hasTerm{field: lhs, value: unescapedRHS})
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("invalid selector: '%s'; can't understand '%s'", selector, part)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if len(items) == 1 {
|
|
||||||
return items[0].Transform(fn)
|
|
||||||
}
|
|
||||||
return andTerm(items).Transform(fn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// OneTermEqualSelector returns an object that matches objects where one field/field equals one value.
|
|
||||||
// Cannot return an error.
|
|
||||||
func OneTermEqualSelector(k, v string) Selector {
|
|
||||||
return &hasTerm{field: k, value: v}
|
|
||||||
}
|
|
||||||
|
|
||||||
// AndSelectors creates a selector that is the logical AND of all the given selectors
|
|
||||||
func AndSelectors(selectors ...Selector) Selector {
|
|
||||||
return andTerm(selectors)
|
|
||||||
}
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 labels implements a simple label system, parsing and matching
|
|
||||||
// selectors with sets of labels.
|
|
||||||
package labels
|
|
||||||
@@ -1,181 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 labels
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Labels allows you to present labels independently from their storage.
|
|
||||||
type Labels interface {
|
|
||||||
// Has returns whether the provided label exists.
|
|
||||||
Has(label string) (exists bool)
|
|
||||||
|
|
||||||
// Get returns the value for the provided label.
|
|
||||||
Get(label string) (value string)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Set is a map of label:value. It implements Labels.
|
|
||||||
type Set map[string]string
|
|
||||||
|
|
||||||
// String returns all labels listed as a human readable string.
|
|
||||||
// Conveniently, exactly the format that ParseSelector takes.
|
|
||||||
func (ls Set) String() string {
|
|
||||||
selector := make([]string, 0, len(ls))
|
|
||||||
for key, value := range ls {
|
|
||||||
selector = append(selector, key+"="+value)
|
|
||||||
}
|
|
||||||
// Sort for determinism.
|
|
||||||
sort.StringSlice(selector).Sort()
|
|
||||||
return strings.Join(selector, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// Has returns whether the provided label exists in the map.
|
|
||||||
func (ls Set) Has(label string) bool {
|
|
||||||
_, exists := ls[label]
|
|
||||||
return exists
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get returns the value in the map for the provided label.
|
|
||||||
func (ls Set) Get(label string) string {
|
|
||||||
return ls[label]
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsSelector converts labels into a selectors.
|
|
||||||
func (ls Set) AsSelector() Selector {
|
|
||||||
return SelectorFromSet(ls)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AsSelectorPreValidated converts labels into a selector, but
|
|
||||||
// assumes that labels are already validated and thus don't
|
|
||||||
// preform any validation.
|
|
||||||
// According to our measurements this is significantly faster
|
|
||||||
// in codepaths that matter at high sccale.
|
|
||||||
func (ls Set) AsSelectorPreValidated() Selector {
|
|
||||||
return SelectorFromValidatedSet(ls)
|
|
||||||
}
|
|
||||||
|
|
||||||
// FormatLables convert label map into plain string
|
|
||||||
func FormatLabels(labelMap map[string]string) string {
|
|
||||||
l := Set(labelMap).String()
|
|
||||||
if l == "" {
|
|
||||||
l = "<none>"
|
|
||||||
}
|
|
||||||
return l
|
|
||||||
}
|
|
||||||
|
|
||||||
// Conflicts takes 2 maps and returns true if there a key match between
|
|
||||||
// the maps but the value doesn't match, and returns false in other cases
|
|
||||||
func Conflicts(labels1, labels2 Set) bool {
|
|
||||||
small := labels1
|
|
||||||
big := labels2
|
|
||||||
if len(labels2) < len(labels1) {
|
|
||||||
small = labels2
|
|
||||||
big = labels1
|
|
||||||
}
|
|
||||||
|
|
||||||
for k, v := range small {
|
|
||||||
if val, match := big[k]; match {
|
|
||||||
if val != v {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Merge combines given maps, and does not check for any conflicts
|
|
||||||
// between the maps. In case of conflicts, second map (labels2) wins
|
|
||||||
func Merge(labels1, labels2 Set) Set {
|
|
||||||
mergedMap := Set{}
|
|
||||||
|
|
||||||
for k, v := range labels1 {
|
|
||||||
mergedMap[k] = v
|
|
||||||
}
|
|
||||||
for k, v := range labels2 {
|
|
||||||
mergedMap[k] = v
|
|
||||||
}
|
|
||||||
return mergedMap
|
|
||||||
}
|
|
||||||
|
|
||||||
// Equals returns true if the given maps are equal
|
|
||||||
func Equals(labels1, labels2 Set) bool {
|
|
||||||
if len(labels1) != len(labels2) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
for k, v := range labels1 {
|
|
||||||
value, ok := labels2[k]
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if value != v {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// AreLabelsInWhiteList verifies if the provided label list
|
|
||||||
// is in the provided whitelist and returns true, otherwise false.
|
|
||||||
func AreLabelsInWhiteList(labels, whitelist Set) bool {
|
|
||||||
if len(whitelist) == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
for k, v := range labels {
|
|
||||||
value, ok := whitelist[k]
|
|
||||||
if !ok {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
if value != v {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// ConvertSelectorToLabelsMap converts selector string to labels map
|
|
||||||
// and validates keys and values
|
|
||||||
func ConvertSelectorToLabelsMap(selector string) (Set, error) {
|
|
||||||
labelsMap := Set{}
|
|
||||||
|
|
||||||
if len(selector) == 0 {
|
|
||||||
return labelsMap, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
labels := strings.Split(selector, ",")
|
|
||||||
for _, label := range labels {
|
|
||||||
l := strings.Split(label, "=")
|
|
||||||
if len(l) != 2 {
|
|
||||||
return labelsMap, fmt.Errorf("invalid selector: %s", l)
|
|
||||||
}
|
|
||||||
key := strings.TrimSpace(l[0])
|
|
||||||
if err := validateLabelKey(key); err != nil {
|
|
||||||
return labelsMap, err
|
|
||||||
}
|
|
||||||
value := strings.TrimSpace(l[1])
|
|
||||||
if err := validateLabelValue(value); err != nil {
|
|
||||||
return labelsMap, err
|
|
||||||
}
|
|
||||||
labelsMap[key] = value
|
|
||||||
}
|
|
||||||
return labelsMap, nil
|
|
||||||
}
|
|
||||||
@@ -1,836 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 labels
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"fmt"
|
|
||||||
"sort"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/golang/glog"
|
|
||||||
"k8s.io/apimachinery/pkg/selection"
|
|
||||||
"k8s.io/apimachinery/pkg/util/sets"
|
|
||||||
"k8s.io/apimachinery/pkg/util/validation"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Requirements is AND of all requirements.
|
|
||||||
type Requirements []Requirement
|
|
||||||
|
|
||||||
// Selector represents a label selector.
|
|
||||||
type Selector interface {
|
|
||||||
// Matches returns true if this selector matches the given set of labels.
|
|
||||||
Matches(Labels) bool
|
|
||||||
|
|
||||||
// Empty returns true if this selector does not restrict the selection space.
|
|
||||||
Empty() bool
|
|
||||||
|
|
||||||
// String returns a human readable string that represents this selector.
|
|
||||||
String() string
|
|
||||||
|
|
||||||
// Add adds requirements to the Selector
|
|
||||||
Add(r ...Requirement) Selector
|
|
||||||
|
|
||||||
// Requirements converts this interface into Requirements to expose
|
|
||||||
// more detailed selection information.
|
|
||||||
// If there are querying parameters, it will return converted requirements and selectable=true.
|
|
||||||
// If this selector doesn't want to select anything, it will return selectable=false.
|
|
||||||
Requirements() (requirements Requirements, selectable bool)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Everything returns a selector that matches all labels.
|
|
||||||
func Everything() Selector {
|
|
||||||
return internalSelector{}
|
|
||||||
}
|
|
||||||
|
|
||||||
type nothingSelector struct{}
|
|
||||||
|
|
||||||
func (n nothingSelector) Matches(_ Labels) bool { return false }
|
|
||||||
func (n nothingSelector) Empty() bool { return false }
|
|
||||||
func (n nothingSelector) String() string { return "" }
|
|
||||||
func (n nothingSelector) Add(_ ...Requirement) Selector { return n }
|
|
||||||
func (n nothingSelector) Requirements() (Requirements, bool) { return nil, false }
|
|
||||||
|
|
||||||
// Nothing returns a selector that matches no labels
|
|
||||||
func Nothing() Selector {
|
|
||||||
return nothingSelector{}
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewSelector() Selector {
|
|
||||||
return internalSelector(nil)
|
|
||||||
}
|
|
||||||
|
|
||||||
type internalSelector []Requirement
|
|
||||||
|
|
||||||
// Sort by key to obtain determisitic parser
|
|
||||||
type ByKey []Requirement
|
|
||||||
|
|
||||||
func (a ByKey) Len() int { return len(a) }
|
|
||||||
|
|
||||||
func (a ByKey) Swap(i, j int) { a[i], a[j] = a[j], a[i] }
|
|
||||||
|
|
||||||
func (a ByKey) Less(i, j int) bool { return a[i].key < a[j].key }
|
|
||||||
|
|
||||||
// Requirement contains values, a key, and an operator that relates the key and values.
|
|
||||||
// The zero value of Requirement is invalid.
|
|
||||||
// Requirement implements both set based match and exact match
|
|
||||||
// Requirement should be initialized via NewRequirement constructor for creating a valid Requirement.
|
|
||||||
type Requirement struct {
|
|
||||||
key string
|
|
||||||
operator selection.Operator
|
|
||||||
// In huge majority of cases we have at most one value here.
|
|
||||||
// It is generally faster to operate on a single-element slice
|
|
||||||
// than on a single-element map, so we have a slice here.
|
|
||||||
strValues []string
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewRequirement is the constructor for a Requirement.
|
|
||||||
// If any of these rules is violated, an error is returned:
|
|
||||||
// (1) The operator can only be In, NotIn, Equals, DoubleEquals, NotEquals, Exists, or DoesNotExist.
|
|
||||||
// (2) If the operator is In or NotIn, the values set must be non-empty.
|
|
||||||
// (3) If the operator is Equals, DoubleEquals, or NotEquals, the values set must contain one value.
|
|
||||||
// (4) If the operator is Exists or DoesNotExist, the value set must be empty.
|
|
||||||
// (5) If the operator is Gt or Lt, the values set must contain only one value, which will be interpreted as an integer.
|
|
||||||
// (6) The key is invalid due to its length, or sequence
|
|
||||||
// of characters. See validateLabelKey for more details.
|
|
||||||
//
|
|
||||||
// The empty string is a valid value in the input values set.
|
|
||||||
func NewRequirement(key string, op selection.Operator, vals []string) (*Requirement, error) {
|
|
||||||
if err := validateLabelKey(key); err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
switch op {
|
|
||||||
case selection.In, selection.NotIn:
|
|
||||||
if len(vals) == 0 {
|
|
||||||
return nil, fmt.Errorf("for 'in', 'notin' operators, values set can't be empty")
|
|
||||||
}
|
|
||||||
case selection.Equals, selection.DoubleEquals, selection.NotEquals:
|
|
||||||
if len(vals) != 1 {
|
|
||||||
return nil, fmt.Errorf("exact-match compatibility requires one single value")
|
|
||||||
}
|
|
||||||
case selection.Exists, selection.DoesNotExist:
|
|
||||||
if len(vals) != 0 {
|
|
||||||
return nil, fmt.Errorf("values set must be empty for exists and does not exist")
|
|
||||||
}
|
|
||||||
case selection.GreaterThan, selection.LessThan:
|
|
||||||
if len(vals) != 1 {
|
|
||||||
return nil, fmt.Errorf("for 'Gt', 'Lt' operators, exactly one value is required")
|
|
||||||
}
|
|
||||||
for i := range vals {
|
|
||||||
if _, err := strconv.ParseInt(vals[i], 10, 64); err != nil {
|
|
||||||
return nil, fmt.Errorf("for 'Gt', 'Lt' operators, the value must be an integer")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("operator '%v' is not recognized", op)
|
|
||||||
}
|
|
||||||
|
|
||||||
for i := range vals {
|
|
||||||
if err := validateLabelValue(vals[i]); err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
sort.Strings(vals)
|
|
||||||
return &Requirement{key: key, operator: op, strValues: vals}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (r *Requirement) hasValue(value string) bool {
|
|
||||||
for i := range r.strValues {
|
|
||||||
if r.strValues[i] == value {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Matches returns true if the Requirement matches the input Labels.
|
|
||||||
// There is a match in the following cases:
|
|
||||||
// (1) The operator is Exists and Labels has the Requirement's key.
|
|
||||||
// (2) The operator is In, Labels has the Requirement's key and Labels'
|
|
||||||
// value for that key is in Requirement's value set.
|
|
||||||
// (3) The operator is NotIn, Labels has the Requirement's key and
|
|
||||||
// Labels' value for that key is not in Requirement's value set.
|
|
||||||
// (4) The operator is DoesNotExist or NotIn and Labels does not have the
|
|
||||||
// Requirement's key.
|
|
||||||
// (5) The operator is GreaterThanOperator or LessThanOperator, and Labels has
|
|
||||||
// the Requirement's key and the corresponding value satisfies mathematical inequality.
|
|
||||||
func (r *Requirement) Matches(ls Labels) bool {
|
|
||||||
switch r.operator {
|
|
||||||
case selection.In, selection.Equals, selection.DoubleEquals:
|
|
||||||
if !ls.Has(r.key) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
return r.hasValue(ls.Get(r.key))
|
|
||||||
case selection.NotIn, selection.NotEquals:
|
|
||||||
if !ls.Has(r.key) {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
return !r.hasValue(ls.Get(r.key))
|
|
||||||
case selection.Exists:
|
|
||||||
return ls.Has(r.key)
|
|
||||||
case selection.DoesNotExist:
|
|
||||||
return !ls.Has(r.key)
|
|
||||||
case selection.GreaterThan, selection.LessThan:
|
|
||||||
if !ls.Has(r.key) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
lsValue, err := strconv.ParseInt(ls.Get(r.key), 10, 64)
|
|
||||||
if err != nil {
|
|
||||||
glog.V(10).Infof("ParseInt failed for value %+v in label %+v, %+v", ls.Get(r.key), ls, err)
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// There should be only one strValue in r.strValues, and can be converted to a integer.
|
|
||||||
if len(r.strValues) != 1 {
|
|
||||||
glog.V(10).Infof("Invalid values count %+v of requirement %#v, for 'Gt', 'Lt' operators, exactly one value is required", len(r.strValues), r)
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
var rValue int64
|
|
||||||
for i := range r.strValues {
|
|
||||||
rValue, err = strconv.ParseInt(r.strValues[i], 10, 64)
|
|
||||||
if err != nil {
|
|
||||||
glog.V(10).Infof("ParseInt failed for value %+v in requirement %#v, for 'Gt', 'Lt' operators, the value must be an integer", r.strValues[i], r)
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return (r.operator == selection.GreaterThan && lsValue > rValue) || (r.operator == selection.LessThan && lsValue < rValue)
|
|
||||||
default:
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (r *Requirement) Key() string {
|
|
||||||
return r.key
|
|
||||||
}
|
|
||||||
func (r *Requirement) Operator() selection.Operator {
|
|
||||||
return r.operator
|
|
||||||
}
|
|
||||||
func (r *Requirement) Values() sets.String {
|
|
||||||
ret := sets.String{}
|
|
||||||
for i := range r.strValues {
|
|
||||||
ret.Insert(r.strValues[i])
|
|
||||||
}
|
|
||||||
return ret
|
|
||||||
}
|
|
||||||
|
|
||||||
// Return true if the internalSelector doesn't restrict selection space
|
|
||||||
func (lsel internalSelector) Empty() bool {
|
|
||||||
if lsel == nil {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
return len(lsel) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
// String returns a human-readable string that represents this
|
|
||||||
// Requirement. If called on an invalid Requirement, an error is
|
|
||||||
// returned. See NewRequirement for creating a valid Requirement.
|
|
||||||
func (r *Requirement) String() string {
|
|
||||||
var buffer bytes.Buffer
|
|
||||||
if r.operator == selection.DoesNotExist {
|
|
||||||
buffer.WriteString("!")
|
|
||||||
}
|
|
||||||
buffer.WriteString(r.key)
|
|
||||||
|
|
||||||
switch r.operator {
|
|
||||||
case selection.Equals:
|
|
||||||
buffer.WriteString("=")
|
|
||||||
case selection.DoubleEquals:
|
|
||||||
buffer.WriteString("==")
|
|
||||||
case selection.NotEquals:
|
|
||||||
buffer.WriteString("!=")
|
|
||||||
case selection.In:
|
|
||||||
buffer.WriteString(" in ")
|
|
||||||
case selection.NotIn:
|
|
||||||
buffer.WriteString(" notin ")
|
|
||||||
case selection.GreaterThan:
|
|
||||||
buffer.WriteString(">")
|
|
||||||
case selection.LessThan:
|
|
||||||
buffer.WriteString("<")
|
|
||||||
case selection.Exists, selection.DoesNotExist:
|
|
||||||
return buffer.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
switch r.operator {
|
|
||||||
case selection.In, selection.NotIn:
|
|
||||||
buffer.WriteString("(")
|
|
||||||
}
|
|
||||||
if len(r.strValues) == 1 {
|
|
||||||
buffer.WriteString(r.strValues[0])
|
|
||||||
} else { // only > 1 since == 0 prohibited by NewRequirement
|
|
||||||
buffer.WriteString(strings.Join(r.strValues, ","))
|
|
||||||
}
|
|
||||||
|
|
||||||
switch r.operator {
|
|
||||||
case selection.In, selection.NotIn:
|
|
||||||
buffer.WriteString(")")
|
|
||||||
}
|
|
||||||
return buffer.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add adds requirements to the selector. It copies the current selector returning a new one
|
|
||||||
func (lsel internalSelector) Add(reqs ...Requirement) Selector {
|
|
||||||
var sel internalSelector
|
|
||||||
for ix := range lsel {
|
|
||||||
sel = append(sel, lsel[ix])
|
|
||||||
}
|
|
||||||
for _, r := range reqs {
|
|
||||||
sel = append(sel, r)
|
|
||||||
}
|
|
||||||
sort.Sort(ByKey(sel))
|
|
||||||
return sel
|
|
||||||
}
|
|
||||||
|
|
||||||
// Matches for a internalSelector returns true if all
|
|
||||||
// its Requirements match the input Labels. If any
|
|
||||||
// Requirement does not match, false is returned.
|
|
||||||
func (lsel internalSelector) Matches(l Labels) bool {
|
|
||||||
for ix := range lsel {
|
|
||||||
if matches := lsel[ix].Matches(l); !matches {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (lsel internalSelector) Requirements() (Requirements, bool) { return Requirements(lsel), true }
|
|
||||||
|
|
||||||
// String returns a comma-separated string of all
|
|
||||||
// the internalSelector Requirements' human-readable strings.
|
|
||||||
func (lsel internalSelector) String() string {
|
|
||||||
var reqs []string
|
|
||||||
for ix := range lsel {
|
|
||||||
reqs = append(reqs, lsel[ix].String())
|
|
||||||
}
|
|
||||||
return strings.Join(reqs, ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// constants definition for lexer token
|
|
||||||
type Token int
|
|
||||||
|
|
||||||
const (
|
|
||||||
ErrorToken Token = iota
|
|
||||||
EndOfStringToken
|
|
||||||
ClosedParToken
|
|
||||||
CommaToken
|
|
||||||
DoesNotExistToken
|
|
||||||
DoubleEqualsToken
|
|
||||||
EqualsToken
|
|
||||||
GreaterThanToken
|
|
||||||
IdentifierToken // to represent keys and values
|
|
||||||
InToken
|
|
||||||
LessThanToken
|
|
||||||
NotEqualsToken
|
|
||||||
NotInToken
|
|
||||||
OpenParToken
|
|
||||||
)
|
|
||||||
|
|
||||||
// string2token contains the mapping between lexer Token and token literal
|
|
||||||
// (except IdentifierToken, EndOfStringToken and ErrorToken since it makes no sense)
|
|
||||||
var string2token = map[string]Token{
|
|
||||||
")": ClosedParToken,
|
|
||||||
",": CommaToken,
|
|
||||||
"!": DoesNotExistToken,
|
|
||||||
"==": DoubleEqualsToken,
|
|
||||||
"=": EqualsToken,
|
|
||||||
">": GreaterThanToken,
|
|
||||||
"in": InToken,
|
|
||||||
"<": LessThanToken,
|
|
||||||
"!=": NotEqualsToken,
|
|
||||||
"notin": NotInToken,
|
|
||||||
"(": OpenParToken,
|
|
||||||
}
|
|
||||||
|
|
||||||
// The item produced by the lexer. It contains the Token and the literal.
|
|
||||||
type ScannedItem struct {
|
|
||||||
tok Token
|
|
||||||
literal string
|
|
||||||
}
|
|
||||||
|
|
||||||
// isWhitespace returns true if the rune is a space, tab, or newline.
|
|
||||||
func isWhitespace(ch byte) bool {
|
|
||||||
return ch == ' ' || ch == '\t' || ch == '\r' || ch == '\n'
|
|
||||||
}
|
|
||||||
|
|
||||||
// isSpecialSymbol detect if the character ch can be an operator
|
|
||||||
func isSpecialSymbol(ch byte) bool {
|
|
||||||
switch ch {
|
|
||||||
case '=', '!', '(', ')', ',', '>', '<':
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Lexer represents the Lexer struct for label selector.
|
|
||||||
// It contains necessary informationt to tokenize the input string
|
|
||||||
type Lexer struct {
|
|
||||||
// s stores the string to be tokenized
|
|
||||||
s string
|
|
||||||
// pos is the position currently tokenized
|
|
||||||
pos int
|
|
||||||
}
|
|
||||||
|
|
||||||
// read return the character currently lexed
|
|
||||||
// increment the position and check the buffer overflow
|
|
||||||
func (l *Lexer) read() (b byte) {
|
|
||||||
b = 0
|
|
||||||
if l.pos < len(l.s) {
|
|
||||||
b = l.s[l.pos]
|
|
||||||
l.pos++
|
|
||||||
}
|
|
||||||
return b
|
|
||||||
}
|
|
||||||
|
|
||||||
// unread 'undoes' the last read character
|
|
||||||
func (l *Lexer) unread() {
|
|
||||||
l.pos--
|
|
||||||
}
|
|
||||||
|
|
||||||
// scanIdOrKeyword scans string to recognize literal token (for example 'in') or an identifier.
|
|
||||||
func (l *Lexer) scanIdOrKeyword() (tok Token, lit string) {
|
|
||||||
var buffer []byte
|
|
||||||
IdentifierLoop:
|
|
||||||
for {
|
|
||||||
switch ch := l.read(); {
|
|
||||||
case ch == 0:
|
|
||||||
break IdentifierLoop
|
|
||||||
case isSpecialSymbol(ch) || isWhitespace(ch):
|
|
||||||
l.unread()
|
|
||||||
break IdentifierLoop
|
|
||||||
default:
|
|
||||||
buffer = append(buffer, ch)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
s := string(buffer)
|
|
||||||
if val, ok := string2token[s]; ok { // is a literal token?
|
|
||||||
return val, s
|
|
||||||
}
|
|
||||||
return IdentifierToken, s // otherwise is an identifier
|
|
||||||
}
|
|
||||||
|
|
||||||
// scanSpecialSymbol scans string starting with special symbol.
|
|
||||||
// special symbol identify non literal operators. "!=", "==", "="
|
|
||||||
func (l *Lexer) scanSpecialSymbol() (Token, string) {
|
|
||||||
lastScannedItem := ScannedItem{}
|
|
||||||
var buffer []byte
|
|
||||||
SpecialSymbolLoop:
|
|
||||||
for {
|
|
||||||
switch ch := l.read(); {
|
|
||||||
case ch == 0:
|
|
||||||
break SpecialSymbolLoop
|
|
||||||
case isSpecialSymbol(ch):
|
|
||||||
buffer = append(buffer, ch)
|
|
||||||
if token, ok := string2token[string(buffer)]; ok {
|
|
||||||
lastScannedItem = ScannedItem{tok: token, literal: string(buffer)}
|
|
||||||
} else if lastScannedItem.tok != 0 {
|
|
||||||
l.unread()
|
|
||||||
break SpecialSymbolLoop
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
l.unread()
|
|
||||||
break SpecialSymbolLoop
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if lastScannedItem.tok == 0 {
|
|
||||||
return ErrorToken, fmt.Sprintf("error expected: keyword found '%s'", buffer)
|
|
||||||
}
|
|
||||||
return lastScannedItem.tok, lastScannedItem.literal
|
|
||||||
}
|
|
||||||
|
|
||||||
// skipWhiteSpaces consumes all blank characters
|
|
||||||
// returning the first non blank character
|
|
||||||
func (l *Lexer) skipWhiteSpaces(ch byte) byte {
|
|
||||||
for {
|
|
||||||
if !isWhitespace(ch) {
|
|
||||||
return ch
|
|
||||||
}
|
|
||||||
ch = l.read()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Lex returns a pair of Token and the literal
|
|
||||||
// literal is meaningfull only for IdentifierToken token
|
|
||||||
func (l *Lexer) Lex() (tok Token, lit string) {
|
|
||||||
switch ch := l.skipWhiteSpaces(l.read()); {
|
|
||||||
case ch == 0:
|
|
||||||
return EndOfStringToken, ""
|
|
||||||
case isSpecialSymbol(ch):
|
|
||||||
l.unread()
|
|
||||||
return l.scanSpecialSymbol()
|
|
||||||
default:
|
|
||||||
l.unread()
|
|
||||||
return l.scanIdOrKeyword()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Parser data structure contains the label selector parser data structure
|
|
||||||
type Parser struct {
|
|
||||||
l *Lexer
|
|
||||||
scannedItems []ScannedItem
|
|
||||||
position int
|
|
||||||
}
|
|
||||||
|
|
||||||
// Parser context represents context during parsing:
|
|
||||||
// some literal for example 'in' and 'notin' can be
|
|
||||||
// recognized as operator for example 'x in (a)' but
|
|
||||||
// it can be recognized as value for example 'value in (in)'
|
|
||||||
type ParserContext int
|
|
||||||
|
|
||||||
const (
|
|
||||||
KeyAndOperator ParserContext = iota
|
|
||||||
Values
|
|
||||||
)
|
|
||||||
|
|
||||||
// lookahead func returns the current token and string. No increment of current position
|
|
||||||
func (p *Parser) lookahead(context ParserContext) (Token, string) {
|
|
||||||
tok, lit := p.scannedItems[p.position].tok, p.scannedItems[p.position].literal
|
|
||||||
if context == Values {
|
|
||||||
switch tok {
|
|
||||||
case InToken, NotInToken:
|
|
||||||
tok = IdentifierToken
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return tok, lit
|
|
||||||
}
|
|
||||||
|
|
||||||
// consume returns current token and string. Increments the the position
|
|
||||||
func (p *Parser) consume(context ParserContext) (Token, string) {
|
|
||||||
p.position++
|
|
||||||
tok, lit := p.scannedItems[p.position-1].tok, p.scannedItems[p.position-1].literal
|
|
||||||
if context == Values {
|
|
||||||
switch tok {
|
|
||||||
case InToken, NotInToken:
|
|
||||||
tok = IdentifierToken
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return tok, lit
|
|
||||||
}
|
|
||||||
|
|
||||||
// scan runs through the input string and stores the ScannedItem in an array
|
|
||||||
// Parser can now lookahead and consume the tokens
|
|
||||||
func (p *Parser) scan() {
|
|
||||||
for {
|
|
||||||
token, literal := p.l.Lex()
|
|
||||||
p.scannedItems = append(p.scannedItems, ScannedItem{token, literal})
|
|
||||||
if token == EndOfStringToken {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// parse runs the left recursive descending algorithm
|
|
||||||
// on input string. It returns a list of Requirement objects.
|
|
||||||
func (p *Parser) parse() (internalSelector, error) {
|
|
||||||
p.scan() // init scannedItems
|
|
||||||
|
|
||||||
var requirements internalSelector
|
|
||||||
for {
|
|
||||||
tok, lit := p.lookahead(Values)
|
|
||||||
switch tok {
|
|
||||||
case IdentifierToken, DoesNotExistToken:
|
|
||||||
r, err := p.parseRequirement()
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("unable to parse requirement: %v", err)
|
|
||||||
}
|
|
||||||
requirements = append(requirements, *r)
|
|
||||||
t, l := p.consume(Values)
|
|
||||||
switch t {
|
|
||||||
case EndOfStringToken:
|
|
||||||
return requirements, nil
|
|
||||||
case CommaToken:
|
|
||||||
t2, l2 := p.lookahead(Values)
|
|
||||||
if t2 != IdentifierToken && t2 != DoesNotExistToken {
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: identifier after ','", l2)
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: ',' or 'end of string'", l)
|
|
||||||
}
|
|
||||||
case EndOfStringToken:
|
|
||||||
return requirements, nil
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: !, identifier, or 'end of string'", lit)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (p *Parser) parseRequirement() (*Requirement, error) {
|
|
||||||
key, operator, err := p.parseKeyAndInferOperator()
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
if operator == selection.Exists || operator == selection.DoesNotExist { // operator found lookahead set checked
|
|
||||||
return NewRequirement(key, operator, []string{})
|
|
||||||
}
|
|
||||||
operator, err = p.parseOperator()
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
var values sets.String
|
|
||||||
switch operator {
|
|
||||||
case selection.In, selection.NotIn:
|
|
||||||
values, err = p.parseValues()
|
|
||||||
case selection.Equals, selection.DoubleEquals, selection.NotEquals, selection.GreaterThan, selection.LessThan:
|
|
||||||
values, err = p.parseExactValue()
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return NewRequirement(key, operator, values.List())
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseKeyAndInferOperator parse literals.
|
|
||||||
// in case of no operator '!, in, notin, ==, =, !=' are found
|
|
||||||
// the 'exists' operator is inferred
|
|
||||||
func (p *Parser) parseKeyAndInferOperator() (string, selection.Operator, error) {
|
|
||||||
var operator selection.Operator
|
|
||||||
tok, literal := p.consume(Values)
|
|
||||||
if tok == DoesNotExistToken {
|
|
||||||
operator = selection.DoesNotExist
|
|
||||||
tok, literal = p.consume(Values)
|
|
||||||
}
|
|
||||||
if tok != IdentifierToken {
|
|
||||||
err := fmt.Errorf("found '%s', expected: identifier", literal)
|
|
||||||
return "", "", err
|
|
||||||
}
|
|
||||||
if err := validateLabelKey(literal); err != nil {
|
|
||||||
return "", "", err
|
|
||||||
}
|
|
||||||
if t, _ := p.lookahead(Values); t == EndOfStringToken || t == CommaToken {
|
|
||||||
if operator != selection.DoesNotExist {
|
|
||||||
operator = selection.Exists
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return literal, operator, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseOperator return operator and eventually matchType
|
|
||||||
// matchType can be exact
|
|
||||||
func (p *Parser) parseOperator() (op selection.Operator, err error) {
|
|
||||||
tok, lit := p.consume(KeyAndOperator)
|
|
||||||
switch tok {
|
|
||||||
// DoesNotExistToken shouldn't be here because it's a unary operator, not a binary operator
|
|
||||||
case InToken:
|
|
||||||
op = selection.In
|
|
||||||
case EqualsToken:
|
|
||||||
op = selection.Equals
|
|
||||||
case DoubleEqualsToken:
|
|
||||||
op = selection.DoubleEquals
|
|
||||||
case GreaterThanToken:
|
|
||||||
op = selection.GreaterThan
|
|
||||||
case LessThanToken:
|
|
||||||
op = selection.LessThan
|
|
||||||
case NotInToken:
|
|
||||||
op = selection.NotIn
|
|
||||||
case NotEqualsToken:
|
|
||||||
op = selection.NotEquals
|
|
||||||
default:
|
|
||||||
return "", fmt.Errorf("found '%s', expected: '=', '!=', '==', 'in', notin'", lit)
|
|
||||||
}
|
|
||||||
return op, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseValues parses the values for set based matching (x,y,z)
|
|
||||||
func (p *Parser) parseValues() (sets.String, error) {
|
|
||||||
tok, lit := p.consume(Values)
|
|
||||||
if tok != OpenParToken {
|
|
||||||
return nil, fmt.Errorf("found '%s' expected: '('", lit)
|
|
||||||
}
|
|
||||||
tok, lit = p.lookahead(Values)
|
|
||||||
switch tok {
|
|
||||||
case IdentifierToken, CommaToken:
|
|
||||||
s, err := p.parseIdentifiersList() // handles general cases
|
|
||||||
if err != nil {
|
|
||||||
return s, err
|
|
||||||
}
|
|
||||||
if tok, _ = p.consume(Values); tok != ClosedParToken {
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: ')'", lit)
|
|
||||||
}
|
|
||||||
return s, nil
|
|
||||||
case ClosedParToken: // handles "()"
|
|
||||||
p.consume(Values)
|
|
||||||
return sets.NewString(""), nil
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: ',', ')' or identifier", lit)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseIdentifiersList parses a (possibly empty) list of
|
|
||||||
// of comma separated (possibly empty) identifiers
|
|
||||||
func (p *Parser) parseIdentifiersList() (sets.String, error) {
|
|
||||||
s := sets.NewString()
|
|
||||||
for {
|
|
||||||
tok, lit := p.consume(Values)
|
|
||||||
switch tok {
|
|
||||||
case IdentifierToken:
|
|
||||||
s.Insert(lit)
|
|
||||||
tok2, lit2 := p.lookahead(Values)
|
|
||||||
switch tok2 {
|
|
||||||
case CommaToken:
|
|
||||||
continue
|
|
||||||
case ClosedParToken:
|
|
||||||
return s, nil
|
|
||||||
default:
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: ',' or ')'", lit2)
|
|
||||||
}
|
|
||||||
case CommaToken: // handled here since we can have "(,"
|
|
||||||
if s.Len() == 0 {
|
|
||||||
s.Insert("") // to handle (,
|
|
||||||
}
|
|
||||||
tok2, _ := p.lookahead(Values)
|
|
||||||
if tok2 == ClosedParToken {
|
|
||||||
s.Insert("") // to handle ,) Double "" removed by StringSet
|
|
||||||
return s, nil
|
|
||||||
}
|
|
||||||
if tok2 == CommaToken {
|
|
||||||
p.consume(Values)
|
|
||||||
s.Insert("") // to handle ,, Double "" removed by StringSet
|
|
||||||
}
|
|
||||||
default: // it can be operator
|
|
||||||
return s, fmt.Errorf("found '%s', expected: ',', or identifier", lit)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseExactValue parses the only value for exact match style
|
|
||||||
func (p *Parser) parseExactValue() (sets.String, error) {
|
|
||||||
s := sets.NewString()
|
|
||||||
tok, lit := p.lookahead(Values)
|
|
||||||
if tok == EndOfStringToken || tok == CommaToken {
|
|
||||||
s.Insert("")
|
|
||||||
return s, nil
|
|
||||||
}
|
|
||||||
tok, lit = p.consume(Values)
|
|
||||||
if tok == IdentifierToken {
|
|
||||||
s.Insert(lit)
|
|
||||||
return s, nil
|
|
||||||
}
|
|
||||||
return nil, fmt.Errorf("found '%s', expected: identifier", lit)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Parse takes a string representing a selector and returns a selector
|
|
||||||
// object, or an error. This parsing function differs from ParseSelector
|
|
||||||
// as they parse different selectors with different syntaxes.
|
|
||||||
// The input will cause an error if it does not follow this form:
|
|
||||||
//
|
|
||||||
// <selector-syntax> ::= <requirement> | <requirement> "," <selector-syntax>
|
|
||||||
// <requirement> ::= [!] KEY [ <set-based-restriction> | <exact-match-restriction> ]
|
|
||||||
// <set-based-restriction> ::= "" | <inclusion-exclusion> <value-set>
|
|
||||||
// <inclusion-exclusion> ::= <inclusion> | <exclusion>
|
|
||||||
// <exclusion> ::= "notin"
|
|
||||||
// <inclusion> ::= "in"
|
|
||||||
// <value-set> ::= "(" <values> ")"
|
|
||||||
// <values> ::= VALUE | VALUE "," <values>
|
|
||||||
// <exact-match-restriction> ::= ["="|"=="|"!="] VALUE
|
|
||||||
//
|
|
||||||
// KEY is a sequence of one or more characters following [ DNS_SUBDOMAIN "/" ] DNS_LABEL. Max length is 63 characters.
|
|
||||||
// VALUE is a sequence of zero or more characters "([A-Za-z0-9_-\.])". Max length is 63 characters.
|
|
||||||
// Delimiter is white space: (' ', '\t')
|
|
||||||
// Example of valid syntax:
|
|
||||||
// "x in (foo,,baz),y,z notin ()"
|
|
||||||
//
|
|
||||||
// Note:
|
|
||||||
// (1) Inclusion - " in " - denotes that the KEY exists and is equal to any of the
|
|
||||||
// VALUEs in its requirement
|
|
||||||
// (2) Exclusion - " notin " - denotes that the KEY is not equal to any
|
|
||||||
// of the VALUEs in its requirement or does not exist
|
|
||||||
// (3) The empty string is a valid VALUE
|
|
||||||
// (4) A requirement with just a KEY - as in "y" above - denotes that
|
|
||||||
// the KEY exists and can be any VALUE.
|
|
||||||
// (5) A requirement with just !KEY requires that the KEY not exist.
|
|
||||||
//
|
|
||||||
func Parse(selector string) (Selector, error) {
|
|
||||||
parsedSelector, err := parse(selector)
|
|
||||||
if err == nil {
|
|
||||||
return parsedSelector, nil
|
|
||||||
}
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// parse parses the string representation of the selector and returns the internalSelector struct.
|
|
||||||
// The callers of this method can then decide how to return the internalSelector struct to their
|
|
||||||
// callers. This function has two callers now, one returns a Selector interface and the other
|
|
||||||
// returns a list of requirements.
|
|
||||||
func parse(selector string) (internalSelector, error) {
|
|
||||||
p := &Parser{l: &Lexer{s: selector, pos: 0}}
|
|
||||||
items, err := p.parse()
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
sort.Sort(ByKey(items)) // sort to grant determistic parsing
|
|
||||||
return internalSelector(items), err
|
|
||||||
}
|
|
||||||
|
|
||||||
func validateLabelKey(k string) error {
|
|
||||||
if errs := validation.IsQualifiedName(k); len(errs) != 0 {
|
|
||||||
return fmt.Errorf("invalid label key %q: %s", k, strings.Join(errs, "; "))
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func validateLabelValue(v string) error {
|
|
||||||
if errs := validation.IsValidLabelValue(v); len(errs) != 0 {
|
|
||||||
return fmt.Errorf("invalid label value: %q: %s", v, strings.Join(errs, "; "))
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// SelectorFromSet returns a Selector which will match exactly the given Set. A
|
|
||||||
// nil and empty Sets are considered equivalent to Everything().
|
|
||||||
func SelectorFromSet(ls Set) Selector {
|
|
||||||
if ls == nil || len(ls) == 0 {
|
|
||||||
return internalSelector{}
|
|
||||||
}
|
|
||||||
var requirements internalSelector
|
|
||||||
for label, value := range ls {
|
|
||||||
if r, err := NewRequirement(label, selection.Equals, []string{value}); err != nil {
|
|
||||||
//TODO: double check errors when input comes from serialization?
|
|
||||||
return internalSelector{}
|
|
||||||
} else {
|
|
||||||
requirements = append(requirements, *r)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// sort to have deterministic string representation
|
|
||||||
sort.Sort(ByKey(requirements))
|
|
||||||
return requirements
|
|
||||||
}
|
|
||||||
|
|
||||||
// SelectorFromValidatedSet returns a Selector which will match exactly the given Set.
|
|
||||||
// A nil and empty Sets are considered equivalent to Everything().
|
|
||||||
// It assumes that Set is already validated and doesn't do any validation.
|
|
||||||
func SelectorFromValidatedSet(ls Set) Selector {
|
|
||||||
if ls == nil || len(ls) == 0 {
|
|
||||||
return internalSelector{}
|
|
||||||
}
|
|
||||||
var requirements internalSelector
|
|
||||||
for label, value := range ls {
|
|
||||||
requirements = append(requirements, Requirement{key: label, operator: selection.Equals, strValues: []string{value}})
|
|
||||||
}
|
|
||||||
// sort to have deterministic string representation
|
|
||||||
sort.Sort(ByKey(requirements))
|
|
||||||
return requirements
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseToRequirements takes a string representing a selector and returns a list of
|
|
||||||
// requirements. This function is suitable for those callers that perform additional
|
|
||||||
// processing on selector requirements.
|
|
||||||
// See the documentation for Parse() function for more details.
|
|
||||||
// TODO: Consider exporting the internalSelector type instead.
|
|
||||||
func ParseToRequirements(selector string) ([]Requirement, error) {
|
|
||||||
return parse(selector)
|
|
||||||
}
|
|
||||||
@@ -1,160 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 openapi
|
|
||||||
|
|
||||||
import (
|
|
||||||
"github.com/emicklei/go-restful"
|
|
||||||
"github.com/go-openapi/spec"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// OpenAPIDefinition describes single type. Normally these definitions are auto-generated using gen-openapi.
|
|
||||||
type OpenAPIDefinition struct {
|
|
||||||
Schema spec.Schema
|
|
||||||
Dependencies []string
|
|
||||||
}
|
|
||||||
|
|
||||||
type ReferenceCallback func(path string) spec.Ref
|
|
||||||
|
|
||||||
// OpenAPIDefinitions is collection of all definitions.
|
|
||||||
type GetOpenAPIDefinitions func(ReferenceCallback) map[string]OpenAPIDefinition
|
|
||||||
|
|
||||||
// OpenAPIDefinitionGetter gets openAPI definitions for a given type. If a type implements this interface,
|
|
||||||
// the definition returned by it will be used, otherwise the auto-generated definitions will be used. See
|
|
||||||
// GetOpenAPITypeFormat for more information about trade-offs of using this interface or GetOpenAPITypeFormat method when
|
|
||||||
// possible.
|
|
||||||
type OpenAPIDefinitionGetter interface {
|
|
||||||
OpenAPIDefinition() *OpenAPIDefinition
|
|
||||||
}
|
|
||||||
|
|
||||||
// Config is set of configuration for openAPI spec generation.
|
|
||||||
type Config struct {
|
|
||||||
// List of supported protocols such as https, http, etc.
|
|
||||||
ProtocolList []string
|
|
||||||
|
|
||||||
// Info is general information about the API.
|
|
||||||
Info *spec.Info
|
|
||||||
|
|
||||||
// DefaultResponse will be used if an operation does not have any responses listed. It
|
|
||||||
// will show up as ... "responses" : {"default" : $DefaultResponse} in the spec.
|
|
||||||
DefaultResponse *spec.Response
|
|
||||||
|
|
||||||
// CommonResponses will be added as a response to all operation specs. This is a good place to add common
|
|
||||||
// responses such as authorization failed.
|
|
||||||
CommonResponses map[int]spec.Response
|
|
||||||
|
|
||||||
// List of webservice's path prefixes to ignore
|
|
||||||
IgnorePrefixes []string
|
|
||||||
|
|
||||||
// OpenAPIDefinitions should provide definition for all models used by routes. Failure to provide this map
|
|
||||||
// or any of the models will result in spec generation failure.
|
|
||||||
GetDefinitions GetOpenAPIDefinitions
|
|
||||||
|
|
||||||
// GetOperationIDAndTags returns operation id and tags for a restful route. It is an optional function to customize operation IDs.
|
|
||||||
GetOperationIDAndTags func(servePath string, r *restful.Route) (string, []string, error)
|
|
||||||
|
|
||||||
// GetDefinitionName returns a friendly name for a definition base on the serving path. parameter `name` is the full name of the definition.
|
|
||||||
// It is an optional function to customize model names.
|
|
||||||
GetDefinitionName func(servePath string, name string) (string, spec.Extensions)
|
|
||||||
|
|
||||||
// PostProcessSpec runs after the spec is ready to serve. It allows a final modification to the spec before serving.
|
|
||||||
PostProcessSpec func(*spec.Swagger) (*spec.Swagger, error)
|
|
||||||
|
|
||||||
// SecurityDefinitions is list of all security definitions for OpenAPI service. If this is not nil, the user of config
|
|
||||||
// is responsible to provide DefaultSecurity and (maybe) add unauthorized response to CommonResponses.
|
|
||||||
SecurityDefinitions *spec.SecurityDefinitions
|
|
||||||
|
|
||||||
// DefaultSecurity for all operations. This will pass as spec.SwaggerProps.Security to OpenAPI.
|
|
||||||
// For most cases, this will be list of acceptable definitions in SecurityDefinitions.
|
|
||||||
DefaultSecurity []map[string][]string
|
|
||||||
}
|
|
||||||
|
|
||||||
// This function is a reference for converting go (or any custom type) to a simple open API type,format pair. There are
|
|
||||||
// two ways to customize spec for a type. If you add it here, a type will be converted to a simple type and the type
|
|
||||||
// comment (the comment that is added before type definition) will be lost. The spec will still have the property
|
|
||||||
// comment. The second way is to implement OpenAPIDefinitionGetter interface. That function can customize the spec (so
|
|
||||||
// the spec does not need to be simple type,format) or can even return a simple type,format (e.g. IntOrString). For simple
|
|
||||||
// type formats, the benefit of adding OpenAPIDefinitionGetter interface is to keep both type and property documentation.
|
|
||||||
// Example:
|
|
||||||
// type Sample struct {
|
|
||||||
// ...
|
|
||||||
// // port of the server
|
|
||||||
// port IntOrString
|
|
||||||
// ...
|
|
||||||
// }
|
|
||||||
// // IntOrString documentation...
|
|
||||||
// type IntOrString { ... }
|
|
||||||
//
|
|
||||||
// Adding IntOrString to this function:
|
|
||||||
// "port" : {
|
|
||||||
// format: "string",
|
|
||||||
// type: "int-or-string",
|
|
||||||
// Description: "port of the server"
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
// Implement OpenAPIDefinitionGetter for IntOrString:
|
|
||||||
//
|
|
||||||
// "port" : {
|
|
||||||
// $Ref: "#/definitions/IntOrString"
|
|
||||||
// Description: "port of the server"
|
|
||||||
// }
|
|
||||||
// ...
|
|
||||||
// definitions:
|
|
||||||
// {
|
|
||||||
// "IntOrString": {
|
|
||||||
// format: "string",
|
|
||||||
// type: "int-or-string",
|
|
||||||
// Description: "IntOrString documentation..." // new
|
|
||||||
// }
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
func GetOpenAPITypeFormat(typeName string) (string, string) {
|
|
||||||
schemaTypeFormatMap := map[string][]string{
|
|
||||||
"uint": {"integer", "int32"},
|
|
||||||
"uint8": {"integer", "byte"},
|
|
||||||
"uint16": {"integer", "int32"},
|
|
||||||
"uint32": {"integer", "int64"},
|
|
||||||
"uint64": {"integer", "int64"},
|
|
||||||
"int": {"integer", "int32"},
|
|
||||||
"int8": {"integer", "byte"},
|
|
||||||
"int16": {"integer", "int32"},
|
|
||||||
"int32": {"integer", "int32"},
|
|
||||||
"int64": {"integer", "int64"},
|
|
||||||
"byte": {"integer", "byte"},
|
|
||||||
"float64": {"number", "double"},
|
|
||||||
"float32": {"number", "float"},
|
|
||||||
"bool": {"boolean", ""},
|
|
||||||
"time.Time": {"string", "date-time"},
|
|
||||||
"string": {"string", ""},
|
|
||||||
"integer": {"integer", ""},
|
|
||||||
"number": {"number", ""},
|
|
||||||
"boolean": {"boolean", ""},
|
|
||||||
"[]byte": {"string", "byte"}, // base64 encoded characters
|
|
||||||
}
|
|
||||||
mapped, ok := schemaTypeFormatMap[typeName]
|
|
||||||
if !ok {
|
|
||||||
return "", ""
|
|
||||||
}
|
|
||||||
return mapped[0], mapped[1]
|
|
||||||
}
|
|
||||||
|
|
||||||
func EscapeJsonPointer(p string) string {
|
|
||||||
// Escaping reference name using rfc6901
|
|
||||||
p = strings.Replace(p, "~", "~0", -1)
|
|
||||||
p = strings.Replace(p, "/", "~1", -1)
|
|
||||||
return p
|
|
||||||
}
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 openapi holds shared codes and types between open API code generator and spec generator.
|
|
||||||
package openapi
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
approvers:
|
|
||||||
- caesarxuchao
|
|
||||||
- deads2k
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
reviewers:
|
|
||||||
- lavalamp
|
|
||||||
- smarterclayton
|
|
||||||
- wojtek-t
|
|
||||||
- deads2k
|
|
||||||
- derekwaynecarr
|
|
||||||
- caesarxuchao
|
|
||||||
- mikedanese
|
|
||||||
- nikhiljindal
|
|
||||||
- gmarek
|
|
||||||
- krousey
|
|
||||||
- timothysc
|
|
||||||
- piosz
|
|
||||||
- mbohlool
|
|
||||||
@@ -1,314 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"encoding/base64"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"net/url"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion/queryparams"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// codec binds an encoder and decoder.
|
|
||||||
type codec struct {
|
|
||||||
Encoder
|
|
||||||
Decoder
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewCodec creates a Codec from an Encoder and Decoder.
|
|
||||||
func NewCodec(e Encoder, d Decoder) Codec {
|
|
||||||
return codec{e, d}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Encode is a convenience wrapper for encoding to a []byte from an Encoder
|
|
||||||
func Encode(e Encoder, obj Object) ([]byte, error) {
|
|
||||||
// TODO: reuse buffer
|
|
||||||
buf := &bytes.Buffer{}
|
|
||||||
if err := e.Encode(obj, buf); err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return buf.Bytes(), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Decode is a convenience wrapper for decoding data into an Object.
|
|
||||||
func Decode(d Decoder, data []byte) (Object, error) {
|
|
||||||
obj, _, err := d.Decode(data, nil, nil)
|
|
||||||
return obj, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// DecodeInto performs a Decode into the provided object.
|
|
||||||
func DecodeInto(d Decoder, data []byte, into Object) error {
|
|
||||||
out, gvk, err := d.Decode(data, nil, into)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if out != into {
|
|
||||||
return fmt.Errorf("unable to decode %s into %v", gvk, reflect.TypeOf(into))
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// EncodeOrDie is a version of Encode which will panic instead of returning an error. For tests.
|
|
||||||
func EncodeOrDie(e Encoder, obj Object) string {
|
|
||||||
bytes, err := Encode(e, obj)
|
|
||||||
if err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return string(bytes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultingSerializer invokes defaulting after decoding.
|
|
||||||
type DefaultingSerializer struct {
|
|
||||||
Defaulter ObjectDefaulter
|
|
||||||
Decoder Decoder
|
|
||||||
// Encoder is optional to allow this type to be used as both a Decoder and an Encoder
|
|
||||||
Encoder
|
|
||||||
}
|
|
||||||
|
|
||||||
// Decode performs a decode and then allows the defaulter to act on the provided object.
|
|
||||||
func (d DefaultingSerializer) Decode(data []byte, defaultGVK *schema.GroupVersionKind, into Object) (Object, *schema.GroupVersionKind, error) {
|
|
||||||
obj, gvk, err := d.Decoder.Decode(data, defaultGVK, into)
|
|
||||||
if err != nil {
|
|
||||||
return obj, gvk, err
|
|
||||||
}
|
|
||||||
d.Defaulter.Default(obj)
|
|
||||||
return obj, gvk, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// UseOrCreateObject returns obj if the canonical ObjectKind returned by the provided typer matches gvk, or
|
|
||||||
// invokes the ObjectCreator to instantiate a new gvk. Returns an error if the typer cannot find the object.
|
|
||||||
func UseOrCreateObject(t ObjectTyper, c ObjectCreater, gvk schema.GroupVersionKind, obj Object) (Object, error) {
|
|
||||||
if obj != nil {
|
|
||||||
kinds, _, err := t.ObjectKinds(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
for _, kind := range kinds {
|
|
||||||
if gvk == kind {
|
|
||||||
return obj, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return c.New(gvk)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NoopEncoder converts an Decoder to a Serializer or Codec for code that expects them but only uses decoding.
|
|
||||||
type NoopEncoder struct {
|
|
||||||
Decoder
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ Serializer = NoopEncoder{}
|
|
||||||
|
|
||||||
func (n NoopEncoder) Encode(obj Object, w io.Writer) error {
|
|
||||||
return fmt.Errorf("encoding is not allowed for this codec: %v", reflect.TypeOf(n.Decoder))
|
|
||||||
}
|
|
||||||
|
|
||||||
// NoopDecoder converts an Encoder to a Serializer or Codec for code that expects them but only uses encoding.
|
|
||||||
type NoopDecoder struct {
|
|
||||||
Encoder
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ Serializer = NoopDecoder{}
|
|
||||||
|
|
||||||
func (n NoopDecoder) Decode(data []byte, gvk *schema.GroupVersionKind, into Object) (Object, *schema.GroupVersionKind, error) {
|
|
||||||
return nil, nil, fmt.Errorf("decoding is not allowed for this codec: %v", reflect.TypeOf(n.Encoder))
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewParameterCodec creates a ParameterCodec capable of transforming url values into versioned objects and back.
|
|
||||||
func NewParameterCodec(scheme *Scheme) ParameterCodec {
|
|
||||||
return ¶meterCodec{
|
|
||||||
typer: scheme,
|
|
||||||
convertor: scheme,
|
|
||||||
creator: scheme,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// parameterCodec implements conversion to and from query parameters and objects.
|
|
||||||
type parameterCodec struct {
|
|
||||||
typer ObjectTyper
|
|
||||||
convertor ObjectConvertor
|
|
||||||
creator ObjectCreater
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ ParameterCodec = ¶meterCodec{}
|
|
||||||
|
|
||||||
// DecodeParameters converts the provided url.Values into an object of type From with the kind of into, and then
|
|
||||||
// converts that object to into (if necessary). Returns an error if the operation cannot be completed.
|
|
||||||
func (c *parameterCodec) DecodeParameters(parameters url.Values, from schema.GroupVersion, into Object) error {
|
|
||||||
if len(parameters) == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
targetGVKs, _, err := c.typer.ObjectKinds(into)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
targetGVK := targetGVKs[0]
|
|
||||||
if targetGVK.GroupVersion() == from {
|
|
||||||
return c.convertor.Convert(¶meters, into, nil)
|
|
||||||
}
|
|
||||||
input, err := c.creator.New(from.WithKind(targetGVK.Kind))
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := c.convertor.Convert(¶meters, input, nil); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return c.convertor.Convert(input, into, nil)
|
|
||||||
}
|
|
||||||
|
|
||||||
// EncodeParameters converts the provided object into the to version, then converts that object to url.Values.
|
|
||||||
// Returns an error if conversion is not possible.
|
|
||||||
func (c *parameterCodec) EncodeParameters(obj Object, to schema.GroupVersion) (url.Values, error) {
|
|
||||||
gvks, _, err := c.typer.ObjectKinds(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
gvk := gvks[0]
|
|
||||||
if to != gvk.GroupVersion() {
|
|
||||||
out, err := c.convertor.ConvertToVersion(obj, to)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
obj = out
|
|
||||||
}
|
|
||||||
return queryparams.Convert(obj)
|
|
||||||
}
|
|
||||||
|
|
||||||
type base64Serializer struct {
|
|
||||||
Serializer
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewBase64Serializer(s Serializer) Serializer {
|
|
||||||
return &base64Serializer{s}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s base64Serializer) Encode(obj Object, stream io.Writer) error {
|
|
||||||
e := base64.NewEncoder(base64.StdEncoding, stream)
|
|
||||||
err := s.Serializer.Encode(obj, e)
|
|
||||||
e.Close()
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s base64Serializer) Decode(data []byte, defaults *schema.GroupVersionKind, into Object) (Object, *schema.GroupVersionKind, error) {
|
|
||||||
out := make([]byte, base64.StdEncoding.DecodedLen(len(data)))
|
|
||||||
n, err := base64.StdEncoding.Decode(out, data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, nil, err
|
|
||||||
}
|
|
||||||
return s.Serializer.Decode(out[:n], defaults, into)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SerializerInfoForMediaType returns the first info in types that has a matching media type (which cannot
|
|
||||||
// include media-type parameters), or the first info with an empty media type, or false if no type matches.
|
|
||||||
func SerializerInfoForMediaType(types []SerializerInfo, mediaType string) (SerializerInfo, bool) {
|
|
||||||
for _, info := range types {
|
|
||||||
if info.MediaType == mediaType {
|
|
||||||
return info, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, info := range types {
|
|
||||||
if len(info.MediaType) == 0 {
|
|
||||||
return info, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return SerializerInfo{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
// InternalGroupVersioner will always prefer the internal version for a given group version kind.
|
|
||||||
InternalGroupVersioner GroupVersioner = internalGroupVersioner{}
|
|
||||||
// DisabledGroupVersioner will reject all kinds passed to it.
|
|
||||||
DisabledGroupVersioner GroupVersioner = disabledGroupVersioner{}
|
|
||||||
)
|
|
||||||
|
|
||||||
type internalGroupVersioner struct{}
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds returns an internal Kind if one is found, or converts the first provided kind to the internal version.
|
|
||||||
func (internalGroupVersioner) KindForGroupVersionKinds(kinds []schema.GroupVersionKind) (schema.GroupVersionKind, bool) {
|
|
||||||
for _, kind := range kinds {
|
|
||||||
if kind.Version == APIVersionInternal {
|
|
||||||
return kind, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, kind := range kinds {
|
|
||||||
return schema.GroupVersionKind{Group: kind.Group, Version: APIVersionInternal, Kind: kind.Kind}, true
|
|
||||||
}
|
|
||||||
return schema.GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
type disabledGroupVersioner struct{}
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds returns false for any input.
|
|
||||||
func (disabledGroupVersioner) KindForGroupVersionKinds(kinds []schema.GroupVersionKind) (schema.GroupVersionKind, bool) {
|
|
||||||
return schema.GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersioners implements GroupVersioner and resolves to the first exact match for any kind.
|
|
||||||
type GroupVersioners []GroupVersioner
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds returns the first match of any of the group versioners, or false if no match occured.
|
|
||||||
func (gvs GroupVersioners) KindForGroupVersionKinds(kinds []schema.GroupVersionKind) (schema.GroupVersionKind, bool) {
|
|
||||||
for _, gv := range gvs {
|
|
||||||
target, ok := gv.KindForGroupVersionKinds(kinds)
|
|
||||||
if !ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
return target, true
|
|
||||||
}
|
|
||||||
return schema.GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Assert that schema.GroupVersion and GroupVersions implement GroupVersioner
|
|
||||||
var _ GroupVersioner = schema.GroupVersion{}
|
|
||||||
var _ GroupVersioner = schema.GroupVersions{}
|
|
||||||
var _ GroupVersioner = multiGroupVersioner{}
|
|
||||||
|
|
||||||
type multiGroupVersioner struct {
|
|
||||||
target schema.GroupVersion
|
|
||||||
acceptedGroupKinds []schema.GroupKind
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewMultiGroupVersioner returns the provided group version for any kind that matches one of the provided group kinds.
|
|
||||||
// Kind may be empty in the provided group kind, in which case any kind will match.
|
|
||||||
func NewMultiGroupVersioner(gv schema.GroupVersion, groupKinds ...schema.GroupKind) GroupVersioner {
|
|
||||||
if len(groupKinds) == 0 || (len(groupKinds) == 1 && groupKinds[0].Group == gv.Group) {
|
|
||||||
return gv
|
|
||||||
}
|
|
||||||
return multiGroupVersioner{target: gv, acceptedGroupKinds: groupKinds}
|
|
||||||
}
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds returns the target group version if any kind matches any of the original group kinds. It will
|
|
||||||
// use the originating kind where possible.
|
|
||||||
func (v multiGroupVersioner) KindForGroupVersionKinds(kinds []schema.GroupVersionKind) (schema.GroupVersionKind, bool) {
|
|
||||||
for _, src := range kinds {
|
|
||||||
for _, kind := range v.acceptedGroupKinds {
|
|
||||||
if kind.Group != src.Group {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if len(kind.Kind) > 0 && kind.Kind != src.Kind {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
return v.target.WithKind(src.Kind), true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return schema.GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
@@ -1,50 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// CheckCodec makes sure that the codec can encode objects like internalType,
|
|
||||||
// decode all of the external types listed, and also decode them into the given
|
|
||||||
// object. (Will modify internalObject.) (Assumes JSON serialization.)
|
|
||||||
// TODO: verify that the correct external version is chosen on encode...
|
|
||||||
func CheckCodec(c Codec, internalType Object, externalTypes ...schema.GroupVersionKind) error {
|
|
||||||
_, err := Encode(c, internalType)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("Internal type not encodable: %v", err)
|
|
||||||
}
|
|
||||||
for _, et := range externalTypes {
|
|
||||||
exBytes := []byte(fmt.Sprintf(`{"kind":"%v","apiVersion":"%v"}`, et.Kind, et.GroupVersion().String()))
|
|
||||||
obj, err := Decode(c, exBytes)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("external type %s not interpretable: %v", et, err)
|
|
||||||
}
|
|
||||||
if reflect.TypeOf(obj) != reflect.TypeOf(internalType) {
|
|
||||||
return fmt.Errorf("decode of external type %s produced: %#v", et, obj)
|
|
||||||
}
|
|
||||||
err = DecodeInto(c, exBytes, internalType)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("external type %s not convertable to internal type: %v", et, err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,98 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Defines conversions between generic types and structs to map query strings
|
|
||||||
// to struct objects.
|
|
||||||
package runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"reflect"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
)
|
|
||||||
|
|
||||||
// JSONKeyMapper uses the struct tags on a conversion to determine the key value for
|
|
||||||
// the other side. Use when mapping from a map[string]* to a struct or vice versa.
|
|
||||||
func JSONKeyMapper(key string, sourceTag, destTag reflect.StructTag) (string, string) {
|
|
||||||
if s := destTag.Get("json"); len(s) > 0 {
|
|
||||||
return strings.SplitN(s, ",", 2)[0], key
|
|
||||||
}
|
|
||||||
if s := sourceTag.Get("json"); len(s) > 0 {
|
|
||||||
return key, strings.SplitN(s, ",", 2)[0]
|
|
||||||
}
|
|
||||||
return key, key
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultStringConversions are helpers for converting []string and string to real values.
|
|
||||||
var DefaultStringConversions = []interface{}{
|
|
||||||
Convert_Slice_string_To_string,
|
|
||||||
Convert_Slice_string_To_int,
|
|
||||||
Convert_Slice_string_To_bool,
|
|
||||||
Convert_Slice_string_To_int64,
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_Slice_string_To_string(input *[]string, out *string, s conversion.Scope) error {
|
|
||||||
if len(*input) == 0 {
|
|
||||||
*out = ""
|
|
||||||
}
|
|
||||||
*out = (*input)[0]
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_Slice_string_To_int(input *[]string, out *int, s conversion.Scope) error {
|
|
||||||
if len(*input) == 0 {
|
|
||||||
*out = 0
|
|
||||||
}
|
|
||||||
str := (*input)[0]
|
|
||||||
i, err := strconv.Atoi(str)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
*out = i
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Conver_Slice_string_To_bool will convert a string parameter to boolean.
|
|
||||||
// Only the absence of a value, a value of "false", or a value of "0" resolve to false.
|
|
||||||
// Any other value (including empty string) resolves to true.
|
|
||||||
func Convert_Slice_string_To_bool(input *[]string, out *bool, s conversion.Scope) error {
|
|
||||||
if len(*input) == 0 {
|
|
||||||
*out = false
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
switch strings.ToLower((*input)[0]) {
|
|
||||||
case "false", "0":
|
|
||||||
*out = false
|
|
||||||
default:
|
|
||||||
*out = true
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_Slice_string_To_int64(input *[]string, out *int64, s conversion.Scope) error {
|
|
||||||
if len(*input) == 0 {
|
|
||||||
*out = 0
|
|
||||||
}
|
|
||||||
str := (*input)[0]
|
|
||||||
i, err := strconv.ParseInt(str, 10, 64)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
*out = i
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
@@ -1,45 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime includes helper functions for working with API objects
|
|
||||||
// that follow the kubernetes API object conventions, which are:
|
|
||||||
//
|
|
||||||
// 0. Your API objects have a common metadata struct member, TypeMeta.
|
|
||||||
// 1. Your code refers to an internal set of API objects.
|
|
||||||
// 2. In a separate package, you have an external set of API objects.
|
|
||||||
// 3. The external set is considered to be versioned, and no breaking
|
|
||||||
// changes are ever made to it (fields may be added but not changed
|
|
||||||
// or removed).
|
|
||||||
// 4. As your api evolves, you'll make an additional versioned package
|
|
||||||
// with every major change.
|
|
||||||
// 5. Versioned packages have conversion functions which convert to
|
|
||||||
// and from the internal version.
|
|
||||||
// 6. You'll continue to support older versions according to your
|
|
||||||
// deprecation policy, and you can easily provide a program/library
|
|
||||||
// to update old versions into new versions because of 5.
|
|
||||||
// 7. All of your serializations and deserializations are handled in a
|
|
||||||
// centralized place.
|
|
||||||
//
|
|
||||||
// Package runtime provides a conversion helper to make 5 easy, and the
|
|
||||||
// Encode/Decode/DecodeInto trio to accomplish 7. You can also register
|
|
||||||
// additional "codecs" which use a version of your choice. It's
|
|
||||||
// recommended that you register your types with runtime in your
|
|
||||||
// package's init function.
|
|
||||||
//
|
|
||||||
// As a bonus, a few common types useful from all api objects and versions
|
|
||||||
// are provided in types.go.
|
|
||||||
|
|
||||||
package runtime
|
|
||||||
@@ -1,136 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
type encodable struct {
|
|
||||||
E Encoder `json:"-"`
|
|
||||||
obj Object
|
|
||||||
versions []schema.GroupVersion
|
|
||||||
}
|
|
||||||
|
|
||||||
func (e encodable) GetObjectKind() schema.ObjectKind { return e.obj.GetObjectKind() }
|
|
||||||
|
|
||||||
// NewEncodable creates an object that will be encoded with the provided codec on demand.
|
|
||||||
// Provided as a convenience for test cases dealing with internal objects.
|
|
||||||
func NewEncodable(e Encoder, obj Object, versions ...schema.GroupVersion) Object {
|
|
||||||
if _, ok := obj.(*Unknown); ok {
|
|
||||||
return obj
|
|
||||||
}
|
|
||||||
return encodable{e, obj, versions}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (re encodable) UnmarshalJSON(in []byte) error {
|
|
||||||
return errors.New("runtime.encodable cannot be unmarshalled from JSON")
|
|
||||||
}
|
|
||||||
|
|
||||||
// Marshal may get called on pointers or values, so implement MarshalJSON on value.
|
|
||||||
// http://stackoverflow.com/questions/21390979/custom-marshaljson-never-gets-called-in-go
|
|
||||||
func (re encodable) MarshalJSON() ([]byte, error) {
|
|
||||||
return Encode(re.E, re.obj)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewEncodableList creates an object that will be encoded with the provided codec on demand.
|
|
||||||
// Provided as a convenience for test cases dealing with internal objects.
|
|
||||||
func NewEncodableList(e Encoder, objects []Object, versions ...schema.GroupVersion) []Object {
|
|
||||||
out := make([]Object, len(objects))
|
|
||||||
for i := range objects {
|
|
||||||
if _, ok := objects[i].(*Unknown); ok {
|
|
||||||
out[i] = objects[i]
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
out[i] = NewEncodable(e, objects[i], versions...)
|
|
||||||
}
|
|
||||||
return out
|
|
||||||
}
|
|
||||||
|
|
||||||
func (re *Unknown) UnmarshalJSON(in []byte) error {
|
|
||||||
if re == nil {
|
|
||||||
return errors.New("runtime.Unknown: UnmarshalJSON on nil pointer")
|
|
||||||
}
|
|
||||||
re.TypeMeta = TypeMeta{}
|
|
||||||
re.Raw = append(re.Raw[0:0], in...)
|
|
||||||
re.ContentEncoding = ""
|
|
||||||
re.ContentType = ContentTypeJSON
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Marshal may get called on pointers or values, so implement MarshalJSON on value.
|
|
||||||
// http://stackoverflow.com/questions/21390979/custom-marshaljson-never-gets-called-in-go
|
|
||||||
func (re Unknown) MarshalJSON() ([]byte, error) {
|
|
||||||
// If ContentType is unset, we assume this is JSON.
|
|
||||||
if re.ContentType != "" && re.ContentType != ContentTypeJSON {
|
|
||||||
return nil, errors.New("runtime.Unknown: MarshalJSON on non-json data")
|
|
||||||
}
|
|
||||||
if re.Raw == nil {
|
|
||||||
return []byte("null"), nil
|
|
||||||
}
|
|
||||||
return re.Raw, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_runtime_Object_To_runtime_RawExtension(in *Object, out *RawExtension, s conversion.Scope) error {
|
|
||||||
if in == nil {
|
|
||||||
out.Raw = []byte("null")
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
obj := *in
|
|
||||||
if unk, ok := obj.(*Unknown); ok {
|
|
||||||
if unk.Raw != nil {
|
|
||||||
out.Raw = unk.Raw
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
obj = out.Object
|
|
||||||
}
|
|
||||||
if obj == nil {
|
|
||||||
out.Raw = nil
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
out.Object = obj
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func Convert_runtime_RawExtension_To_runtime_Object(in *RawExtension, out *Object, s conversion.Scope) error {
|
|
||||||
if in.Object != nil {
|
|
||||||
*out = in.Object
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
data := in.Raw
|
|
||||||
if len(data) == 0 || (len(data) == 4 && string(data) == "null") {
|
|
||||||
*out = nil
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
*out = &Unknown{
|
|
||||||
Raw: data,
|
|
||||||
// TODO: Set ContentEncoding and ContentType appropriately.
|
|
||||||
// Currently we set ContentTypeJSON to make tests passing.
|
|
||||||
ContentType: ContentTypeJSON,
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func DefaultEmbeddedConversions() []interface{} {
|
|
||||||
return []interface{}{
|
|
||||||
Convert_runtime_Object_To_runtime_RawExtension,
|
|
||||||
Convert_runtime_RawExtension_To_runtime_Object,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,102 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
type notRegisteredErr struct {
|
|
||||||
gvk schema.GroupVersionKind
|
|
||||||
t reflect.Type
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewNotRegisteredErr is exposed for testing.
|
|
||||||
func NewNotRegisteredErr(gvk schema.GroupVersionKind, t reflect.Type) error {
|
|
||||||
return ¬RegisteredErr{gvk: gvk, t: t}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (k *notRegisteredErr) Error() string {
|
|
||||||
if k.t != nil {
|
|
||||||
return fmt.Sprintf("no kind is registered for the type %v", k.t)
|
|
||||||
}
|
|
||||||
if len(k.gvk.Kind) == 0 {
|
|
||||||
return fmt.Sprintf("no version %q has been registered", k.gvk.GroupVersion())
|
|
||||||
}
|
|
||||||
if k.gvk.Version == APIVersionInternal {
|
|
||||||
return fmt.Sprintf("no kind %q is registered for the internal version of group %q", k.gvk.Kind, k.gvk.Group)
|
|
||||||
}
|
|
||||||
|
|
||||||
return fmt.Sprintf("no kind %q is registered for version %q", k.gvk.Kind, k.gvk.GroupVersion())
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsNotRegisteredError returns true if the error indicates the provided
|
|
||||||
// object or input data is not registered.
|
|
||||||
func IsNotRegisteredError(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
_, ok := err.(*notRegisteredErr)
|
|
||||||
return ok
|
|
||||||
}
|
|
||||||
|
|
||||||
type missingKindErr struct {
|
|
||||||
data string
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewMissingKindErr(data string) error {
|
|
||||||
return &missingKindErr{data}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (k *missingKindErr) Error() string {
|
|
||||||
return fmt.Sprintf("Object 'Kind' is missing in '%s'", k.data)
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsMissingKind returns true if the error indicates that the provided object
|
|
||||||
// is missing a 'Kind' field.
|
|
||||||
func IsMissingKind(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
_, ok := err.(*missingKindErr)
|
|
||||||
return ok
|
|
||||||
}
|
|
||||||
|
|
||||||
type missingVersionErr struct {
|
|
||||||
data string
|
|
||||||
}
|
|
||||||
|
|
||||||
// IsMissingVersion returns true if the error indicates that the provided object
|
|
||||||
// is missing a 'Version' field.
|
|
||||||
func NewMissingVersionErr(data string) error {
|
|
||||||
return &missingVersionErr{data}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (k *missingVersionErr) Error() string {
|
|
||||||
return fmt.Sprintf("Object 'apiVersion' is missing in '%s'", k.data)
|
|
||||||
}
|
|
||||||
|
|
||||||
func IsMissingVersion(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
_, ok := err.(*missingVersionErr)
|
|
||||||
return ok
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"errors"
|
|
||||||
)
|
|
||||||
|
|
||||||
func (re *RawExtension) UnmarshalJSON(in []byte) error {
|
|
||||||
if re == nil {
|
|
||||||
return errors.New("runtime.RawExtension: UnmarshalJSON on nil pointer")
|
|
||||||
}
|
|
||||||
re.Raw = append(re.Raw[0:0], in...)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Marshal may get called on pointers or values, so implement MarshalJSON on value.
|
|
||||||
// http://stackoverflow.com/questions/21390979/custom-marshaljson-never-gets-called-in-go
|
|
||||||
func (re RawExtension) MarshalJSON() ([]byte, error) {
|
|
||||||
if re.Raw == nil {
|
|
||||||
// TODO: this is to support legacy behavior of JSONPrinter and YAMLPrinter, which
|
|
||||||
// expect to call json.Marshal on arbitrary versioned objects (even those not in
|
|
||||||
// the scheme). pkg/kubectl/resource#AsVersionedObjects and its interaction with
|
|
||||||
// kubectl get on objects not in the scheme needs to be updated to ensure that the
|
|
||||||
// objects that are not part of the scheme are correctly put into the right form.
|
|
||||||
if re.Object != nil {
|
|
||||||
return json.Marshal(re.Object)
|
|
||||||
}
|
|
||||||
return []byte("null"), nil
|
|
||||||
}
|
|
||||||
// TODO: Check whether ContentType is actually JSON before returning it.
|
|
||||||
return re.Raw, nil
|
|
||||||
}
|
|
||||||
@@ -1,767 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Code generated by protoc-gen-gogo.
|
|
||||||
// source: k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/runtime/generated.proto
|
|
||||||
// DO NOT EDIT!
|
|
||||||
|
|
||||||
/*
|
|
||||||
Package runtime is a generated protocol buffer package.
|
|
||||||
|
|
||||||
It is generated from these files:
|
|
||||||
k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/runtime/generated.proto
|
|
||||||
|
|
||||||
It has these top-level messages:
|
|
||||||
RawExtension
|
|
||||||
TypeMeta
|
|
||||||
Unknown
|
|
||||||
*/
|
|
||||||
package runtime
|
|
||||||
|
|
||||||
import proto "github.com/gogo/protobuf/proto"
|
|
||||||
import fmt "fmt"
|
|
||||||
import math "math"
|
|
||||||
|
|
||||||
import strings "strings"
|
|
||||||
import reflect "reflect"
|
|
||||||
|
|
||||||
import io "io"
|
|
||||||
|
|
||||||
// Reference imports to suppress errors if they are not otherwise used.
|
|
||||||
var _ = proto.Marshal
|
|
||||||
var _ = fmt.Errorf
|
|
||||||
var _ = math.Inf
|
|
||||||
|
|
||||||
// This is a compile-time assertion to ensure that this generated file
|
|
||||||
// is compatible with the proto package it is being compiled against.
|
|
||||||
const _ = proto.GoGoProtoPackageIsVersion1
|
|
||||||
|
|
||||||
func (m *RawExtension) Reset() { *m = RawExtension{} }
|
|
||||||
func (*RawExtension) ProtoMessage() {}
|
|
||||||
func (*RawExtension) Descriptor() ([]byte, []int) { return fileDescriptorGenerated, []int{0} }
|
|
||||||
|
|
||||||
func (m *TypeMeta) Reset() { *m = TypeMeta{} }
|
|
||||||
func (*TypeMeta) ProtoMessage() {}
|
|
||||||
func (*TypeMeta) Descriptor() ([]byte, []int) { return fileDescriptorGenerated, []int{1} }
|
|
||||||
|
|
||||||
func (m *Unknown) Reset() { *m = Unknown{} }
|
|
||||||
func (*Unknown) ProtoMessage() {}
|
|
||||||
func (*Unknown) Descriptor() ([]byte, []int) { return fileDescriptorGenerated, []int{2} }
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
proto.RegisterType((*RawExtension)(nil), "k8s.io.apimachinery.pkg.runtime.RawExtension")
|
|
||||||
proto.RegisterType((*TypeMeta)(nil), "k8s.io.apimachinery.pkg.runtime.TypeMeta")
|
|
||||||
proto.RegisterType((*Unknown)(nil), "k8s.io.apimachinery.pkg.runtime.Unknown")
|
|
||||||
}
|
|
||||||
func (m *RawExtension) Marshal() (data []byte, err error) {
|
|
||||||
size := m.Size()
|
|
||||||
data = make([]byte, size)
|
|
||||||
n, err := m.MarshalTo(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return data[:n], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *RawExtension) MarshalTo(data []byte) (int, error) {
|
|
||||||
var i int
|
|
||||||
_ = i
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
if m.Raw != nil {
|
|
||||||
data[i] = 0xa
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.Raw)))
|
|
||||||
i += copy(data[i:], m.Raw)
|
|
||||||
}
|
|
||||||
return i, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *TypeMeta) Marshal() (data []byte, err error) {
|
|
||||||
size := m.Size()
|
|
||||||
data = make([]byte, size)
|
|
||||||
n, err := m.MarshalTo(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return data[:n], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *TypeMeta) MarshalTo(data []byte) (int, error) {
|
|
||||||
var i int
|
|
||||||
_ = i
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
data[i] = 0xa
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.APIVersion)))
|
|
||||||
i += copy(data[i:], m.APIVersion)
|
|
||||||
data[i] = 0x12
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.Kind)))
|
|
||||||
i += copy(data[i:], m.Kind)
|
|
||||||
return i, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *Unknown) Marshal() (data []byte, err error) {
|
|
||||||
size := m.Size()
|
|
||||||
data = make([]byte, size)
|
|
||||||
n, err := m.MarshalTo(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return data[:n], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *Unknown) MarshalTo(data []byte) (int, error) {
|
|
||||||
var i int
|
|
||||||
_ = i
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
data[i] = 0xa
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(m.TypeMeta.Size()))
|
|
||||||
n1, err := m.TypeMeta.MarshalTo(data[i:])
|
|
||||||
if err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
i += n1
|
|
||||||
if m.Raw != nil {
|
|
||||||
data[i] = 0x12
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.Raw)))
|
|
||||||
i += copy(data[i:], m.Raw)
|
|
||||||
}
|
|
||||||
data[i] = 0x1a
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.ContentEncoding)))
|
|
||||||
i += copy(data[i:], m.ContentEncoding)
|
|
||||||
data[i] = 0x22
|
|
||||||
i++
|
|
||||||
i = encodeVarintGenerated(data, i, uint64(len(m.ContentType)))
|
|
||||||
i += copy(data[i:], m.ContentType)
|
|
||||||
return i, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func encodeFixed64Generated(data []byte, offset int, v uint64) int {
|
|
||||||
data[offset] = uint8(v)
|
|
||||||
data[offset+1] = uint8(v >> 8)
|
|
||||||
data[offset+2] = uint8(v >> 16)
|
|
||||||
data[offset+3] = uint8(v >> 24)
|
|
||||||
data[offset+4] = uint8(v >> 32)
|
|
||||||
data[offset+5] = uint8(v >> 40)
|
|
||||||
data[offset+6] = uint8(v >> 48)
|
|
||||||
data[offset+7] = uint8(v >> 56)
|
|
||||||
return offset + 8
|
|
||||||
}
|
|
||||||
func encodeFixed32Generated(data []byte, offset int, v uint32) int {
|
|
||||||
data[offset] = uint8(v)
|
|
||||||
data[offset+1] = uint8(v >> 8)
|
|
||||||
data[offset+2] = uint8(v >> 16)
|
|
||||||
data[offset+3] = uint8(v >> 24)
|
|
||||||
return offset + 4
|
|
||||||
}
|
|
||||||
func encodeVarintGenerated(data []byte, offset int, v uint64) int {
|
|
||||||
for v >= 1<<7 {
|
|
||||||
data[offset] = uint8(v&0x7f | 0x80)
|
|
||||||
v >>= 7
|
|
||||||
offset++
|
|
||||||
}
|
|
||||||
data[offset] = uint8(v)
|
|
||||||
return offset + 1
|
|
||||||
}
|
|
||||||
func (m *RawExtension) Size() (n int) {
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
if m.Raw != nil {
|
|
||||||
l = len(m.Raw)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
}
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *TypeMeta) Size() (n int) {
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
l = len(m.APIVersion)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
l = len(m.Kind)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m *Unknown) Size() (n int) {
|
|
||||||
var l int
|
|
||||||
_ = l
|
|
||||||
l = m.TypeMeta.Size()
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
if m.Raw != nil {
|
|
||||||
l = len(m.Raw)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
}
|
|
||||||
l = len(m.ContentEncoding)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
l = len(m.ContentType)
|
|
||||||
n += 1 + l + sovGenerated(uint64(l))
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
func sovGenerated(x uint64) (n int) {
|
|
||||||
for {
|
|
||||||
n++
|
|
||||||
x >>= 7
|
|
||||||
if x == 0 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
func sozGenerated(x uint64) (n int) {
|
|
||||||
return sovGenerated(uint64((x << 1) ^ uint64((int64(x) >> 63))))
|
|
||||||
}
|
|
||||||
func (this *RawExtension) String() string {
|
|
||||||
if this == nil {
|
|
||||||
return "nil"
|
|
||||||
}
|
|
||||||
s := strings.Join([]string{`&RawExtension{`,
|
|
||||||
`Raw:` + valueToStringGenerated(this.Raw) + `,`,
|
|
||||||
`}`,
|
|
||||||
}, "")
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
func (this *TypeMeta) String() string {
|
|
||||||
if this == nil {
|
|
||||||
return "nil"
|
|
||||||
}
|
|
||||||
s := strings.Join([]string{`&TypeMeta{`,
|
|
||||||
`APIVersion:` + fmt.Sprintf("%v", this.APIVersion) + `,`,
|
|
||||||
`Kind:` + fmt.Sprintf("%v", this.Kind) + `,`,
|
|
||||||
`}`,
|
|
||||||
}, "")
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
func (this *Unknown) String() string {
|
|
||||||
if this == nil {
|
|
||||||
return "nil"
|
|
||||||
}
|
|
||||||
s := strings.Join([]string{`&Unknown{`,
|
|
||||||
`TypeMeta:` + strings.Replace(strings.Replace(this.TypeMeta.String(), "TypeMeta", "TypeMeta", 1), `&`, ``, 1) + `,`,
|
|
||||||
`Raw:` + valueToStringGenerated(this.Raw) + `,`,
|
|
||||||
`ContentEncoding:` + fmt.Sprintf("%v", this.ContentEncoding) + `,`,
|
|
||||||
`ContentType:` + fmt.Sprintf("%v", this.ContentType) + `,`,
|
|
||||||
`}`,
|
|
||||||
}, "")
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
func valueToStringGenerated(v interface{}) string {
|
|
||||||
rv := reflect.ValueOf(v)
|
|
||||||
if rv.IsNil() {
|
|
||||||
return "nil"
|
|
||||||
}
|
|
||||||
pv := reflect.Indirect(rv).Interface()
|
|
||||||
return fmt.Sprintf("*%v", pv)
|
|
||||||
}
|
|
||||||
func (m *RawExtension) Unmarshal(data []byte) error {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
preIndex := iNdEx
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
fieldNum := int32(wire >> 3)
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
if wireType == 4 {
|
|
||||||
return fmt.Errorf("proto: RawExtension: wiretype end group for non-group")
|
|
||||||
}
|
|
||||||
if fieldNum <= 0 {
|
|
||||||
return fmt.Errorf("proto: RawExtension: illegal tag %d (wire type %d)", fieldNum, wire)
|
|
||||||
}
|
|
||||||
switch fieldNum {
|
|
||||||
case 1:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field Raw", wireType)
|
|
||||||
}
|
|
||||||
var byteLen int
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
byteLen |= (int(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if byteLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + byteLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.Raw = append(m.Raw[:0], data[iNdEx:postIndex]...)
|
|
||||||
if m.Raw == nil {
|
|
||||||
m.Raw = []byte{}
|
|
||||||
}
|
|
||||||
iNdEx = postIndex
|
|
||||||
default:
|
|
||||||
iNdEx = preIndex
|
|
||||||
skippy, err := skipGenerated(data[iNdEx:])
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if skippy < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
if (iNdEx + skippy) > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx += skippy
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if iNdEx > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
func (m *TypeMeta) Unmarshal(data []byte) error {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
preIndex := iNdEx
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
fieldNum := int32(wire >> 3)
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
if wireType == 4 {
|
|
||||||
return fmt.Errorf("proto: TypeMeta: wiretype end group for non-group")
|
|
||||||
}
|
|
||||||
if fieldNum <= 0 {
|
|
||||||
return fmt.Errorf("proto: TypeMeta: illegal tag %d (wire type %d)", fieldNum, wire)
|
|
||||||
}
|
|
||||||
switch fieldNum {
|
|
||||||
case 1:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field APIVersion", wireType)
|
|
||||||
}
|
|
||||||
var stringLen uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
stringLen |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
intStringLen := int(stringLen)
|
|
||||||
if intStringLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + intStringLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.APIVersion = string(data[iNdEx:postIndex])
|
|
||||||
iNdEx = postIndex
|
|
||||||
case 2:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field Kind", wireType)
|
|
||||||
}
|
|
||||||
var stringLen uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
stringLen |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
intStringLen := int(stringLen)
|
|
||||||
if intStringLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + intStringLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.Kind = string(data[iNdEx:postIndex])
|
|
||||||
iNdEx = postIndex
|
|
||||||
default:
|
|
||||||
iNdEx = preIndex
|
|
||||||
skippy, err := skipGenerated(data[iNdEx:])
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if skippy < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
if (iNdEx + skippy) > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx += skippy
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if iNdEx > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
func (m *Unknown) Unmarshal(data []byte) error {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
preIndex := iNdEx
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
fieldNum := int32(wire >> 3)
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
if wireType == 4 {
|
|
||||||
return fmt.Errorf("proto: Unknown: wiretype end group for non-group")
|
|
||||||
}
|
|
||||||
if fieldNum <= 0 {
|
|
||||||
return fmt.Errorf("proto: Unknown: illegal tag %d (wire type %d)", fieldNum, wire)
|
|
||||||
}
|
|
||||||
switch fieldNum {
|
|
||||||
case 1:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field TypeMeta", wireType)
|
|
||||||
}
|
|
||||||
var msglen int
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
msglen |= (int(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if msglen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + msglen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
if err := m.TypeMeta.Unmarshal(data[iNdEx:postIndex]); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
iNdEx = postIndex
|
|
||||||
case 2:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field Raw", wireType)
|
|
||||||
}
|
|
||||||
var byteLen int
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
byteLen |= (int(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if byteLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + byteLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.Raw = append(m.Raw[:0], data[iNdEx:postIndex]...)
|
|
||||||
if m.Raw == nil {
|
|
||||||
m.Raw = []byte{}
|
|
||||||
}
|
|
||||||
iNdEx = postIndex
|
|
||||||
case 3:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field ContentEncoding", wireType)
|
|
||||||
}
|
|
||||||
var stringLen uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
stringLen |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
intStringLen := int(stringLen)
|
|
||||||
if intStringLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + intStringLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.ContentEncoding = string(data[iNdEx:postIndex])
|
|
||||||
iNdEx = postIndex
|
|
||||||
case 4:
|
|
||||||
if wireType != 2 {
|
|
||||||
return fmt.Errorf("proto: wrong wireType = %d for field ContentType", wireType)
|
|
||||||
}
|
|
||||||
var stringLen uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
stringLen |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
intStringLen := int(stringLen)
|
|
||||||
if intStringLen < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
postIndex := iNdEx + intStringLen
|
|
||||||
if postIndex > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
m.ContentType = string(data[iNdEx:postIndex])
|
|
||||||
iNdEx = postIndex
|
|
||||||
default:
|
|
||||||
iNdEx = preIndex
|
|
||||||
skippy, err := skipGenerated(data[iNdEx:])
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if skippy < 0 {
|
|
||||||
return ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
if (iNdEx + skippy) > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx += skippy
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if iNdEx > l {
|
|
||||||
return io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
func skipGenerated(data []byte) (n int, err error) {
|
|
||||||
l := len(data)
|
|
||||||
iNdEx := 0
|
|
||||||
for iNdEx < l {
|
|
||||||
var wire uint64
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
wire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
wireType := int(wire & 0x7)
|
|
||||||
switch wireType {
|
|
||||||
case 0:
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
iNdEx++
|
|
||||||
if data[iNdEx-1] < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 1:
|
|
||||||
iNdEx += 8
|
|
||||||
return iNdEx, nil
|
|
||||||
case 2:
|
|
||||||
var length int
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
length |= (int(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
iNdEx += length
|
|
||||||
if length < 0 {
|
|
||||||
return 0, ErrInvalidLengthGenerated
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 3:
|
|
||||||
for {
|
|
||||||
var innerWire uint64
|
|
||||||
var start int = iNdEx
|
|
||||||
for shift := uint(0); ; shift += 7 {
|
|
||||||
if shift >= 64 {
|
|
||||||
return 0, ErrIntOverflowGenerated
|
|
||||||
}
|
|
||||||
if iNdEx >= l {
|
|
||||||
return 0, io.ErrUnexpectedEOF
|
|
||||||
}
|
|
||||||
b := data[iNdEx]
|
|
||||||
iNdEx++
|
|
||||||
innerWire |= (uint64(b) & 0x7F) << shift
|
|
||||||
if b < 0x80 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
innerWireType := int(innerWire & 0x7)
|
|
||||||
if innerWireType == 4 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
next, err := skipGenerated(data[start:])
|
|
||||||
if err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
iNdEx = start + next
|
|
||||||
}
|
|
||||||
return iNdEx, nil
|
|
||||||
case 4:
|
|
||||||
return iNdEx, nil
|
|
||||||
case 5:
|
|
||||||
iNdEx += 4
|
|
||||||
return iNdEx, nil
|
|
||||||
default:
|
|
||||||
return 0, fmt.Errorf("proto: illegal wireType %d", wireType)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
panic("unreachable")
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
ErrInvalidLengthGenerated = fmt.Errorf("proto: negative length found during unmarshaling")
|
|
||||||
ErrIntOverflowGenerated = fmt.Errorf("proto: integer overflow")
|
|
||||||
)
|
|
||||||
|
|
||||||
var fileDescriptorGenerated = []byte{
|
|
||||||
// 391 bytes of a gzipped FileDescriptorProto
|
|
||||||
0x1f, 0x8b, 0x08, 0x00, 0x00, 0x09, 0x6e, 0x88, 0x02, 0xff, 0x84, 0x90, 0x4f, 0x8b, 0xd3, 0x40,
|
|
||||||
0x18, 0xc6, 0x93, 0x6d, 0xa1, 0xeb, 0xb4, 0xb0, 0x32, 0x1e, 0x8c, 0x7b, 0x98, 0x2c, 0x3d, 0xd9,
|
|
||||||
0x83, 0x33, 0xb0, 0x22, 0x78, 0xdd, 0x94, 0x82, 0x22, 0x82, 0x0c, 0xfe, 0x01, 0x4f, 0x4e, 0x93,
|
|
||||||
0x31, 0x1d, 0x62, 0xdf, 0x09, 0x93, 0x89, 0xb1, 0x37, 0x3f, 0x82, 0x1f, 0xab, 0xc7, 0x1e, 0x3d,
|
|
||||||
0x15, 0x1b, 0x3f, 0x84, 0x57, 0xe9, 0x74, 0x5a, 0x6b, 0x45, 0xf6, 0x96, 0x79, 0x9f, 0xe7, 0xf7,
|
|
||||||
0xbc, 0xcf, 0x1b, 0xf4, 0xac, 0x78, 0x5a, 0x51, 0xa5, 0x59, 0x51, 0x4f, 0xa5, 0x01, 0x69, 0x65,
|
|
||||||
0xc5, 0x3e, 0x4b, 0xc8, 0xb4, 0x61, 0x5e, 0x10, 0xa5, 0x9a, 0x8b, 0x74, 0xa6, 0x40, 0x9a, 0x05,
|
|
||||||
0x2b, 0x8b, 0x9c, 0x99, 0x1a, 0xac, 0x9a, 0x4b, 0x96, 0x4b, 0x90, 0x46, 0x58, 0x99, 0xd1, 0xd2,
|
|
||||||
0x68, 0xab, 0x71, 0xbc, 0x03, 0xe8, 0x31, 0x40, 0xcb, 0x22, 0xa7, 0x1e, 0xb8, 0x7c, 0x94, 0x2b,
|
|
||||||
0x3b, 0xab, 0xa7, 0x34, 0xd5, 0x73, 0x96, 0xeb, 0x5c, 0x33, 0xc7, 0x4d, 0xeb, 0x8f, 0xee, 0xe5,
|
|
||||||
0x1e, 0xee, 0x6b, 0x97, 0x77, 0xf9, 0xf8, 0x7f, 0x05, 0x6a, 0xab, 0x3e, 0x31, 0x05, 0xb6, 0xb2,
|
|
||||||
0xe6, 0xb4, 0xc4, 0x70, 0x84, 0x06, 0x5c, 0x34, 0x93, 0x2f, 0x56, 0x42, 0xa5, 0x34, 0xe0, 0x07,
|
|
||||||
0xa8, 0x63, 0x44, 0x13, 0x85, 0x57, 0xe1, 0xc3, 0x41, 0xd2, 0x6b, 0xd7, 0x71, 0x87, 0x8b, 0x86,
|
|
||||||
0x6f, 0x67, 0xc3, 0x0f, 0xe8, 0xfc, 0xf5, 0xa2, 0x94, 0x2f, 0xa5, 0x15, 0xf8, 0x1a, 0x21, 0x51,
|
|
||||||
0xaa, 0xb7, 0xd2, 0x6c, 0x21, 0xe7, 0xbe, 0x93, 0xe0, 0xe5, 0x3a, 0x0e, 0xda, 0x75, 0x8c, 0x6e,
|
|
||||||
0x5e, 0x3d, 0xf7, 0x0a, 0x3f, 0x72, 0xe1, 0x2b, 0xd4, 0x2d, 0x14, 0x64, 0xd1, 0x99, 0x73, 0x0f,
|
|
||||||
0xbc, 0xbb, 0xfb, 0x42, 0x41, 0xc6, 0x9d, 0x32, 0xfc, 0x15, 0xa2, 0xde, 0x1b, 0x28, 0x40, 0x37,
|
|
||||||
0x80, 0xdf, 0xa1, 0x73, 0xeb, 0xb7, 0xb9, 0xfc, 0xfe, 0xf5, 0x88, 0xde, 0xf2, 0xc3, 0xe8, 0xbe,
|
|
||||||
0x5e, 0x72, 0xd7, 0x87, 0x1f, 0x0a, 0xf3, 0x43, 0xd8, 0xfe, 0xc2, 0xb3, 0x7f, 0x2f, 0xc4, 0x37,
|
|
||||||
0xe8, 0x22, 0xd5, 0x60, 0x25, 0xd8, 0x09, 0xa4, 0x3a, 0x53, 0x90, 0x47, 0x1d, 0x57, 0xf6, 0xbe,
|
|
||||||
0xcf, 0xbb, 0x18, 0xff, 0x2d, 0xf3, 0x53, 0x3f, 0x7e, 0x82, 0xfa, 0x7e, 0xb4, 0x5d, 0x1d, 0x75,
|
|
||||||
0x1d, 0x7e, 0xcf, 0xe3, 0xfd, 0xf1, 0x1f, 0x89, 0x1f, 0xfb, 0x92, 0xd1, 0x72, 0x43, 0x82, 0xd5,
|
|
||||||
0x86, 0x04, 0xdf, 0x37, 0x24, 0xf8, 0xda, 0x92, 0x70, 0xd9, 0x92, 0x70, 0xd5, 0x92, 0xf0, 0x47,
|
|
||||||
0x4b, 0xc2, 0x6f, 0x3f, 0x49, 0xf0, 0xbe, 0xe7, 0x8f, 0xfc, 0x1d, 0x00, 0x00, 0xff, 0xff, 0x5d,
|
|
||||||
0x24, 0xc6, 0x1a, 0x81, 0x02, 0x00, 0x00,
|
|
||||||
}
|
|
||||||
@@ -1,128 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
|
|
||||||
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
|
|
||||||
|
|
||||||
syntax = 'proto2';
|
|
||||||
|
|
||||||
package k8s.io.apimachinery.pkg.runtime;
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
|
|
||||||
|
|
||||||
// Package-wide variables from generator "generated".
|
|
||||||
option go_package = "runtime";
|
|
||||||
|
|
||||||
// RawExtension is used to hold extensions in external versions.
|
|
||||||
//
|
|
||||||
// To use this, make a field which has RawExtension as its type in your external, versioned
|
|
||||||
// struct, and Object in your internal struct. You also need to register your
|
|
||||||
// various plugin types.
|
|
||||||
//
|
|
||||||
// // Internal package:
|
|
||||||
// type MyAPIObject struct {
|
|
||||||
// runtime.TypeMeta `json:",inline"`
|
|
||||||
// MyPlugin runtime.Object `json:"myPlugin"`
|
|
||||||
// }
|
|
||||||
// type PluginA struct {
|
|
||||||
// AOption string `json:"aOption"`
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
// // External package:
|
|
||||||
// type MyAPIObject struct {
|
|
||||||
// runtime.TypeMeta `json:",inline"`
|
|
||||||
// MyPlugin runtime.RawExtension `json:"myPlugin"`
|
|
||||||
// }
|
|
||||||
// type PluginA struct {
|
|
||||||
// AOption string `json:"aOption"`
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
// // On the wire, the JSON will look something like this:
|
|
||||||
// {
|
|
||||||
// "kind":"MyAPIObject",
|
|
||||||
// "apiVersion":"v1",
|
|
||||||
// "myPlugin": {
|
|
||||||
// "kind":"PluginA",
|
|
||||||
// "aOption":"foo",
|
|
||||||
// },
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
// So what happens? Decode first uses json or yaml to unmarshal the serialized data into
|
|
||||||
// your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked.
|
|
||||||
// The next step is to copy (using pkg/conversion) into the internal struct. The runtime
|
|
||||||
// package's DefaultScheme has conversion functions installed which will unpack the
|
|
||||||
// JSON stored in RawExtension, turning it into the correct object type, and storing it
|
|
||||||
// in the Object. (TODO: In the case where the object is of an unknown type, a
|
|
||||||
// runtime.Unknown object will be created and stored.)
|
|
||||||
//
|
|
||||||
// +k8s:deepcopy-gen=true
|
|
||||||
// +protobuf=true
|
|
||||||
// +k8s:openapi-gen=true
|
|
||||||
message RawExtension {
|
|
||||||
// Raw is the underlying serialization of this object.
|
|
||||||
//
|
|
||||||
// TODO: Determine how to detect ContentType and ContentEncoding of 'Raw' data.
|
|
||||||
optional bytes raw = 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// TypeMeta is shared by all top level objects. The proper way to use it is to inline it in your type,
|
|
||||||
// like this:
|
|
||||||
// type MyAwesomeAPIObject struct {
|
|
||||||
// runtime.TypeMeta `json:",inline"`
|
|
||||||
// ... // other fields
|
|
||||||
// }
|
|
||||||
// func (obj *MyAwesomeAPIObject) SetGroupVersionKind(gvk *metav1.GroupVersionKind) { metav1.UpdateTypeMeta(obj,gvk) }; GroupVersionKind() *GroupVersionKind
|
|
||||||
//
|
|
||||||
// TypeMeta is provided here for convenience. You may use it directly from this package or define
|
|
||||||
// your own with the same fields.
|
|
||||||
//
|
|
||||||
// +k8s:deepcopy-gen=true
|
|
||||||
// +protobuf=true
|
|
||||||
// +k8s:openapi-gen=true
|
|
||||||
message TypeMeta {
|
|
||||||
// +optional
|
|
||||||
optional string apiVersion = 1;
|
|
||||||
|
|
||||||
// +optional
|
|
||||||
optional string kind = 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unknown allows api objects with unknown types to be passed-through. This can be used
|
|
||||||
// to deal with the API objects from a plug-in. Unknown objects still have functioning
|
|
||||||
// TypeMeta features-- kind, version, etc.
|
|
||||||
// TODO: Make this object have easy access to field based accessors and settors for
|
|
||||||
// metadata and field mutatation.
|
|
||||||
//
|
|
||||||
// +k8s:deepcopy-gen=true
|
|
||||||
// +protobuf=true
|
|
||||||
// +k8s:openapi-gen=true
|
|
||||||
message Unknown {
|
|
||||||
optional TypeMeta typeMeta = 1;
|
|
||||||
|
|
||||||
// Raw will hold the complete serialized object which couldn't be matched
|
|
||||||
// with a registered type. Most likely, nothing should be done with this
|
|
||||||
// except for passing it through the system.
|
|
||||||
optional bytes raw = 2;
|
|
||||||
|
|
||||||
// ContentEncoding is encoding used to encode 'Raw' data.
|
|
||||||
// Unspecified means no encoding.
|
|
||||||
optional string contentEncoding = 3;
|
|
||||||
|
|
||||||
// ContentType is serialization method used to serialize 'Raw'.
|
|
||||||
// Unspecified means ContentTypeJSON.
|
|
||||||
optional string contentType = 4;
|
|
||||||
}
|
|
||||||
|
|
||||||
@@ -1,212 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/util/errors"
|
|
||||||
)
|
|
||||||
|
|
||||||
// unsafeObjectConvertor implements ObjectConvertor using the unsafe conversion path.
|
|
||||||
type unsafeObjectConvertor struct {
|
|
||||||
*Scheme
|
|
||||||
}
|
|
||||||
|
|
||||||
var _ ObjectConvertor = unsafeObjectConvertor{}
|
|
||||||
|
|
||||||
// ConvertToVersion converts in to the provided outVersion without copying the input first, which
|
|
||||||
// is only safe if the output object is not mutated or reused.
|
|
||||||
func (c unsafeObjectConvertor) ConvertToVersion(in Object, outVersion GroupVersioner) (Object, error) {
|
|
||||||
return c.Scheme.UnsafeConvertToVersion(in, outVersion)
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnsafeObjectConvertor performs object conversion without copying the object structure,
|
|
||||||
// for use when the converted object will not be reused or mutated. Primarily for use within
|
|
||||||
// versioned codecs, which use the external object for serialization but do not return it.
|
|
||||||
func UnsafeObjectConvertor(scheme *Scheme) ObjectConvertor {
|
|
||||||
return unsafeObjectConvertor{scheme}
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetField puts the value of src, into fieldName, which must be a member of v.
|
|
||||||
// The value of src must be assignable to the field.
|
|
||||||
func SetField(src interface{}, v reflect.Value, fieldName string) error {
|
|
||||||
field := v.FieldByName(fieldName)
|
|
||||||
if !field.IsValid() {
|
|
||||||
return fmt.Errorf("couldn't find %v field in %#v", fieldName, v.Interface())
|
|
||||||
}
|
|
||||||
srcValue := reflect.ValueOf(src)
|
|
||||||
if srcValue.Type().AssignableTo(field.Type()) {
|
|
||||||
field.Set(srcValue)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if srcValue.Type().ConvertibleTo(field.Type()) {
|
|
||||||
field.Set(srcValue.Convert(field.Type()))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("couldn't assign/convert %v to %v", srcValue.Type(), field.Type())
|
|
||||||
}
|
|
||||||
|
|
||||||
// Field puts the value of fieldName, which must be a member of v, into dest,
|
|
||||||
// which must be a variable to which this field's value can be assigned.
|
|
||||||
func Field(v reflect.Value, fieldName string, dest interface{}) error {
|
|
||||||
field := v.FieldByName(fieldName)
|
|
||||||
if !field.IsValid() {
|
|
||||||
return fmt.Errorf("couldn't find %v field in %#v", fieldName, v.Interface())
|
|
||||||
}
|
|
||||||
destValue, err := conversion.EnforcePtr(dest)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if field.Type().AssignableTo(destValue.Type()) {
|
|
||||||
destValue.Set(field)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if field.Type().ConvertibleTo(destValue.Type()) {
|
|
||||||
destValue.Set(field.Convert(destValue.Type()))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("couldn't assign/convert %v to %v", field.Type(), destValue.Type())
|
|
||||||
}
|
|
||||||
|
|
||||||
// fieldPtr puts the address of fieldName, which must be a member of v,
|
|
||||||
// into dest, which must be an address of a variable to which this field's
|
|
||||||
// address can be assigned.
|
|
||||||
func FieldPtr(v reflect.Value, fieldName string, dest interface{}) error {
|
|
||||||
field := v.FieldByName(fieldName)
|
|
||||||
if !field.IsValid() {
|
|
||||||
return fmt.Errorf("couldn't find %v field in %#v", fieldName, v.Interface())
|
|
||||||
}
|
|
||||||
v, err := conversion.EnforcePtr(dest)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
field = field.Addr()
|
|
||||||
if field.Type().AssignableTo(v.Type()) {
|
|
||||||
v.Set(field)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if field.Type().ConvertibleTo(v.Type()) {
|
|
||||||
v.Set(field.Convert(v.Type()))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("couldn't assign/convert %v to %v", field.Type(), v.Type())
|
|
||||||
}
|
|
||||||
|
|
||||||
// EncodeList ensures that each object in an array is converted to a Unknown{} in serialized form.
|
|
||||||
// TODO: accept a content type.
|
|
||||||
func EncodeList(e Encoder, objects []Object) error {
|
|
||||||
var errs []error
|
|
||||||
for i := range objects {
|
|
||||||
data, err := Encode(e, objects[i])
|
|
||||||
if err != nil {
|
|
||||||
errs = append(errs, err)
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
// TODO: Set ContentEncoding and ContentType.
|
|
||||||
objects[i] = &Unknown{Raw: data}
|
|
||||||
}
|
|
||||||
return errors.NewAggregate(errs)
|
|
||||||
}
|
|
||||||
|
|
||||||
func decodeListItem(obj *Unknown, decoders []Decoder) (Object, error) {
|
|
||||||
for _, decoder := range decoders {
|
|
||||||
// TODO: Decode based on ContentType.
|
|
||||||
obj, err := Decode(decoder, obj.Raw)
|
|
||||||
if err != nil {
|
|
||||||
if IsNotRegisteredError(err) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return obj, nil
|
|
||||||
}
|
|
||||||
// could not decode, so leave the object as Unknown, but give the decoders the
|
|
||||||
// chance to set Unknown.TypeMeta if it is available.
|
|
||||||
for _, decoder := range decoders {
|
|
||||||
if err := DecodeInto(decoder, obj.Raw, obj); err == nil {
|
|
||||||
return obj, nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return obj, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// DecodeList alters the list in place, attempting to decode any objects found in
|
|
||||||
// the list that have the Unknown type. Any errors that occur are returned
|
|
||||||
// after the entire list is processed. Decoders are tried in order.
|
|
||||||
func DecodeList(objects []Object, decoders ...Decoder) []error {
|
|
||||||
errs := []error(nil)
|
|
||||||
for i, obj := range objects {
|
|
||||||
switch t := obj.(type) {
|
|
||||||
case *Unknown:
|
|
||||||
decoded, err := decodeListItem(t, decoders)
|
|
||||||
if err != nil {
|
|
||||||
errs = append(errs, err)
|
|
||||||
break
|
|
||||||
}
|
|
||||||
objects[i] = decoded
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return errs
|
|
||||||
}
|
|
||||||
|
|
||||||
// MultiObjectTyper returns the types of objects across multiple schemes in order.
|
|
||||||
type MultiObjectTyper []ObjectTyper
|
|
||||||
|
|
||||||
var _ ObjectTyper = MultiObjectTyper{}
|
|
||||||
|
|
||||||
func (m MultiObjectTyper) ObjectKinds(obj Object) (gvks []schema.GroupVersionKind, unversionedType bool, err error) {
|
|
||||||
for _, t := range m {
|
|
||||||
gvks, unversionedType, err = t.ObjectKinds(obj)
|
|
||||||
if err == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
func (m MultiObjectTyper) Recognizes(gvk schema.GroupVersionKind) bool {
|
|
||||||
for _, t := range m {
|
|
||||||
if t.Recognizes(gvk) {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// SetZeroValue would set the object of objPtr to zero value of its type.
|
|
||||||
func SetZeroValue(objPtr Object) error {
|
|
||||||
v, err := conversion.EnforcePtr(objPtr)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
v.Set(reflect.Zero(v.Type()))
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultFramer is valid for any stream that can read objects serially without
|
|
||||||
// any separation in the stream.
|
|
||||||
var DefaultFramer = defaultFramer{}
|
|
||||||
|
|
||||||
type defaultFramer struct{}
|
|
||||||
|
|
||||||
func (defaultFramer) NewFrameReader(r io.ReadCloser) io.ReadCloser { return r }
|
|
||||||
func (defaultFramer) NewFrameWriter(w io.Writer) io.Writer { return w }
|
|
||||||
@@ -1,251 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"io"
|
|
||||||
"net/url"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
const (
|
|
||||||
// APIVersionInternal may be used if you are registering a type that should not
|
|
||||||
// be considered stable or serialized - it is a convention only and has no
|
|
||||||
// special behavior in this package.
|
|
||||||
APIVersionInternal = "__internal"
|
|
||||||
)
|
|
||||||
|
|
||||||
// GroupVersioner refines a set of possible conversion targets into a single option.
|
|
||||||
type GroupVersioner interface {
|
|
||||||
// KindForGroupVersionKinds returns a desired target group version kind for the given input, or returns ok false if no
|
|
||||||
// target is known. In general, if the return target is not in the input list, the caller is expected to invoke
|
|
||||||
// Scheme.New(target) and then perform a conversion between the current Go type and the destination Go type.
|
|
||||||
// Sophisticated implementations may use additional information about the input kinds to pick a destination kind.
|
|
||||||
KindForGroupVersionKinds(kinds []schema.GroupVersionKind) (target schema.GroupVersionKind, ok bool)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Encoders write objects to a serialized form
|
|
||||||
type Encoder interface {
|
|
||||||
// Encode writes an object to a stream. Implementations may return errors if the versions are
|
|
||||||
// incompatible, or if no conversion is defined.
|
|
||||||
Encode(obj Object, w io.Writer) error
|
|
||||||
}
|
|
||||||
|
|
||||||
// Decoders attempt to load an object from data.
|
|
||||||
type Decoder interface {
|
|
||||||
// Decode attempts to deserialize the provided data using either the innate typing of the scheme or the
|
|
||||||
// default kind, group, and version provided. It returns a decoded object as well as the kind, group, and
|
|
||||||
// version from the serialized data, or an error. If into is non-nil, it will be used as the target type
|
|
||||||
// and implementations may choose to use it rather than reallocating an object. However, the object is not
|
|
||||||
// guaranteed to be populated. The returned object is not guaranteed to match into. If defaults are
|
|
||||||
// provided, they are applied to the data by default. If no defaults or partial defaults are provided, the
|
|
||||||
// type of the into may be used to guide conversion decisions.
|
|
||||||
Decode(data []byte, defaults *schema.GroupVersionKind, into Object) (Object, *schema.GroupVersionKind, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Serializer is the core interface for transforming objects into a serialized format and back.
|
|
||||||
// Implementations may choose to perform conversion of the object, but no assumptions should be made.
|
|
||||||
type Serializer interface {
|
|
||||||
Encoder
|
|
||||||
Decoder
|
|
||||||
}
|
|
||||||
|
|
||||||
// Codec is a Serializer that deals with the details of versioning objects. It offers the same
|
|
||||||
// interface as Serializer, so this is a marker to consumers that care about the version of the objects
|
|
||||||
// they receive.
|
|
||||||
type Codec Serializer
|
|
||||||
|
|
||||||
// ParameterCodec defines methods for serializing and deserializing API objects to url.Values and
|
|
||||||
// performing any necessary conversion. Unlike the normal Codec, query parameters are not self describing
|
|
||||||
// and the desired version must be specified.
|
|
||||||
type ParameterCodec interface {
|
|
||||||
// DecodeParameters takes the given url.Values in the specified group version and decodes them
|
|
||||||
// into the provided object, or returns an error.
|
|
||||||
DecodeParameters(parameters url.Values, from schema.GroupVersion, into Object) error
|
|
||||||
// EncodeParameters encodes the provided object as query parameters or returns an error.
|
|
||||||
EncodeParameters(obj Object, to schema.GroupVersion) (url.Values, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Framer is a factory for creating readers and writers that obey a particular framing pattern.
|
|
||||||
type Framer interface {
|
|
||||||
NewFrameReader(r io.ReadCloser) io.ReadCloser
|
|
||||||
NewFrameWriter(w io.Writer) io.Writer
|
|
||||||
}
|
|
||||||
|
|
||||||
// SerializerInfo contains information about a specific serialization format
|
|
||||||
type SerializerInfo struct {
|
|
||||||
// MediaType is the value that represents this serializer over the wire.
|
|
||||||
MediaType string
|
|
||||||
// EncodesAsText indicates this serializer can be encoded to UTF-8 safely.
|
|
||||||
EncodesAsText bool
|
|
||||||
// Serializer is the individual object serializer for this media type.
|
|
||||||
Serializer Serializer
|
|
||||||
// PrettySerializer, if set, can serialize this object in a form biased towards
|
|
||||||
// readability.
|
|
||||||
PrettySerializer Serializer
|
|
||||||
// StreamSerializer, if set, describes the streaming serialization format
|
|
||||||
// for this media type.
|
|
||||||
StreamSerializer *StreamSerializerInfo
|
|
||||||
}
|
|
||||||
|
|
||||||
// StreamSerializerInfo contains information about a specific stream serialization format
|
|
||||||
type StreamSerializerInfo struct {
|
|
||||||
// EncodesAsText indicates this serializer can be encoded to UTF-8 safely.
|
|
||||||
EncodesAsText bool
|
|
||||||
// Serializer is the top level object serializer for this type when streaming
|
|
||||||
Serializer
|
|
||||||
// Framer is the factory for retrieving streams that separate objects on the wire
|
|
||||||
Framer
|
|
||||||
}
|
|
||||||
|
|
||||||
// NegotiatedSerializer is an interface used for obtaining encoders, decoders, and serializers
|
|
||||||
// for multiple supported media types. This would commonly be accepted by a server component
|
|
||||||
// that performs HTTP content negotiation to accept multiple formats.
|
|
||||||
type NegotiatedSerializer interface {
|
|
||||||
// SupportedMediaTypes is the media types supported for reading and writing single objects.
|
|
||||||
SupportedMediaTypes() []SerializerInfo
|
|
||||||
|
|
||||||
// EncoderForVersion returns an encoder that ensures objects being written to the provided
|
|
||||||
// serializer are in the provided group version.
|
|
||||||
EncoderForVersion(serializer Encoder, gv GroupVersioner) Encoder
|
|
||||||
// DecoderForVersion returns a decoder that ensures objects being read by the provided
|
|
||||||
// serializer are in the provided group version by default.
|
|
||||||
DecoderToVersion(serializer Decoder, gv GroupVersioner) Decoder
|
|
||||||
}
|
|
||||||
|
|
||||||
// StorageSerializer is an interface used for obtaining encoders, decoders, and serializers
|
|
||||||
// that can read and write data at rest. This would commonly be used by client tools that must
|
|
||||||
// read files, or server side storage interfaces that persist restful objects.
|
|
||||||
type StorageSerializer interface {
|
|
||||||
// SupportedMediaTypes are the media types supported for reading and writing objects.
|
|
||||||
SupportedMediaTypes() []SerializerInfo
|
|
||||||
|
|
||||||
// UniversalDeserializer returns a Serializer that can read objects in multiple supported formats
|
|
||||||
// by introspecting the data at rest.
|
|
||||||
UniversalDeserializer() Decoder
|
|
||||||
|
|
||||||
// EncoderForVersion returns an encoder that ensures objects being written to the provided
|
|
||||||
// serializer are in the provided group version.
|
|
||||||
EncoderForVersion(serializer Encoder, gv GroupVersioner) Encoder
|
|
||||||
// DecoderForVersion returns a decoder that ensures objects being read by the provided
|
|
||||||
// serializer are in the provided group version by default.
|
|
||||||
DecoderToVersion(serializer Decoder, gv GroupVersioner) Decoder
|
|
||||||
}
|
|
||||||
|
|
||||||
// NestedObjectEncoder is an optional interface that objects may implement to be given
|
|
||||||
// an opportunity to encode any nested Objects / RawExtensions during serialization.
|
|
||||||
type NestedObjectEncoder interface {
|
|
||||||
EncodeNestedObjects(e Encoder) error
|
|
||||||
}
|
|
||||||
|
|
||||||
// NestedObjectDecoder is an optional interface that objects may implement to be given
|
|
||||||
// an opportunity to decode any nested Objects / RawExtensions during serialization.
|
|
||||||
type NestedObjectDecoder interface {
|
|
||||||
DecodeNestedObjects(d Decoder) error
|
|
||||||
}
|
|
||||||
|
|
||||||
///////////////////////////////////////////////////////////////////////////////
|
|
||||||
// Non-codec interfaces
|
|
||||||
|
|
||||||
type ObjectDefaulter interface {
|
|
||||||
// Default takes an object (must be a pointer) and applies any default values.
|
|
||||||
// Defaulters may not error.
|
|
||||||
Default(in Object)
|
|
||||||
}
|
|
||||||
|
|
||||||
type ObjectVersioner interface {
|
|
||||||
ConvertToVersion(in Object, gv GroupVersioner) (out Object, err error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectConvertor converts an object to a different version.
|
|
||||||
type ObjectConvertor interface {
|
|
||||||
// Convert attempts to convert one object into another, or returns an error. This method does
|
|
||||||
// not guarantee the in object is not mutated. The context argument will be passed to
|
|
||||||
// all nested conversions.
|
|
||||||
Convert(in, out, context interface{}) error
|
|
||||||
// ConvertToVersion takes the provided object and converts it the provided version. This
|
|
||||||
// method does not guarantee that the in object is not mutated. This method is similar to
|
|
||||||
// Convert() but handles specific details of choosing the correct output version.
|
|
||||||
ConvertToVersion(in Object, gv GroupVersioner) (out Object, err error)
|
|
||||||
ConvertFieldLabel(version, kind, label, value string) (string, string, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectTyper contains methods for extracting the APIVersion and Kind
|
|
||||||
// of objects.
|
|
||||||
type ObjectTyper interface {
|
|
||||||
// ObjectKinds returns the all possible group,version,kind of the provided object, true if
|
|
||||||
// the object is unversioned, or an error if the object is not recognized
|
|
||||||
// (IsNotRegisteredError will return true).
|
|
||||||
ObjectKinds(Object) ([]schema.GroupVersionKind, bool, error)
|
|
||||||
// Recognizes returns true if the scheme is able to handle the provided version and kind,
|
|
||||||
// or more precisely that the provided version is a possible conversion or decoding
|
|
||||||
// target.
|
|
||||||
Recognizes(gvk schema.GroupVersionKind) bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectCreater contains methods for instantiating an object by kind and version.
|
|
||||||
type ObjectCreater interface {
|
|
||||||
New(kind schema.GroupVersionKind) (out Object, err error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectCopier duplicates an object.
|
|
||||||
type ObjectCopier interface {
|
|
||||||
// Copy returns an exact copy of the provided Object, or an error if the
|
|
||||||
// copy could not be completed.
|
|
||||||
Copy(Object) (Object, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ResourceVersioner provides methods for setting and retrieving
|
|
||||||
// the resource version from an API object.
|
|
||||||
type ResourceVersioner interface {
|
|
||||||
SetResourceVersion(obj Object, version string) error
|
|
||||||
ResourceVersion(obj Object) (string, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SelfLinker provides methods for setting and retrieving the SelfLink field of an API object.
|
|
||||||
type SelfLinker interface {
|
|
||||||
SetSelfLink(obj Object, selfLink string) error
|
|
||||||
SelfLink(obj Object) (string, error)
|
|
||||||
|
|
||||||
// Knowing Name is sometimes necessary to use a SelfLinker.
|
|
||||||
Name(obj Object) (string, error)
|
|
||||||
// Knowing Namespace is sometimes necessary to use a SelfLinker
|
|
||||||
Namespace(obj Object) (string, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// All API types registered with Scheme must support the Object interface. Since objects in a scheme are
|
|
||||||
// expected to be serialized to the wire, the interface an Object must provide to the Scheme allows
|
|
||||||
// serializers to set the kind, version, and group the object is represented as. An Object may choose
|
|
||||||
// to return a no-op ObjectKindAccessor in cases where it is not expected to be serialized.
|
|
||||||
type Object interface {
|
|
||||||
GetObjectKind() schema.ObjectKind
|
|
||||||
}
|
|
||||||
|
|
||||||
// Unstructured objects store values as map[string]interface{}, with only values that can be serialized
|
|
||||||
// to JSON allowed.
|
|
||||||
type Unstructured interface {
|
|
||||||
// IsUnstructuredObject is a marker interface to allow objects that can be serialized but not introspected
|
|
||||||
// to bypass conversion.
|
|
||||||
IsUnstructuredObject()
|
|
||||||
// IsList returns true if this type is a list or matches the list convention - has an array called "items".
|
|
||||||
IsList() bool
|
|
||||||
// UnstructuredContent returns a non-nil, mutable map of the contents of this object. Values may be
|
|
||||||
// []interface{}, map[string]interface{}, or any primitive type. Contents are typically serialized to
|
|
||||||
// and from JSON.
|
|
||||||
UnstructuredContent() map[string]interface{}
|
|
||||||
}
|
|
||||||
@@ -1,61 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 runtime
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
|
|
||||||
// SetGroupVersionKind satisfies the ObjectKind interface for all objects that embed TypeMeta
|
|
||||||
func (obj *TypeMeta) SetGroupVersionKind(gvk schema.GroupVersionKind) {
|
|
||||||
obj.APIVersion, obj.Kind = gvk.ToAPIVersionAndKind()
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionKind satisfies the ObjectKind interface for all objects that embed TypeMeta
|
|
||||||
func (obj *TypeMeta) GroupVersionKind() schema.GroupVersionKind {
|
|
||||||
return schema.FromAPIVersionAndKind(obj.APIVersion, obj.Kind)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (obj *Unknown) GetObjectKind() schema.ObjectKind { return &obj.TypeMeta }
|
|
||||||
|
|
||||||
// GetObjectKind implements Object for VersionedObjects, returning an empty ObjectKind
|
|
||||||
// interface if no objects are provided, or the ObjectKind interface of the object in the
|
|
||||||
// highest array position.
|
|
||||||
func (obj *VersionedObjects) GetObjectKind() schema.ObjectKind {
|
|
||||||
last := obj.Last()
|
|
||||||
if last == nil {
|
|
||||||
return schema.EmptyObjectKind
|
|
||||||
}
|
|
||||||
return last.GetObjectKind()
|
|
||||||
}
|
|
||||||
|
|
||||||
// First returns the leftmost object in the VersionedObjects array, which is usually the
|
|
||||||
// object as serialized on the wire.
|
|
||||||
func (obj *VersionedObjects) First() Object {
|
|
||||||
if len(obj.Objects) == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return obj.Objects[0]
|
|
||||||
}
|
|
||||||
|
|
||||||
// Last is the rightmost object in the VersionedObjects array, which is the object after
|
|
||||||
// all transformations have been applied. This is the same object that would be returned
|
|
||||||
// by Decode in a normal invocation (without VersionedObjects in the into argument).
|
|
||||||
func (obj *VersionedObjects) Last() Object {
|
|
||||||
if len(obj.Objects) == 0 {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return obj.Objects[len(obj.Objects)-1]
|
|
||||||
}
|
|
||||||
@@ -1,59 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Code generated by protoc-gen-gogo.
|
|
||||||
// source: k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/runtime/schema/generated.proto
|
|
||||||
// DO NOT EDIT!
|
|
||||||
|
|
||||||
/*
|
|
||||||
Package schema is a generated protocol buffer package.
|
|
||||||
|
|
||||||
It is generated from these files:
|
|
||||||
k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/runtime/schema/generated.proto
|
|
||||||
|
|
||||||
It has these top-level messages:
|
|
||||||
*/
|
|
||||||
package schema
|
|
||||||
|
|
||||||
import proto "github.com/gogo/protobuf/proto"
|
|
||||||
import fmt "fmt"
|
|
||||||
import math "math"
|
|
||||||
|
|
||||||
// Reference imports to suppress errors if they are not otherwise used.
|
|
||||||
var _ = proto.Marshal
|
|
||||||
var _ = fmt.Errorf
|
|
||||||
var _ = math.Inf
|
|
||||||
|
|
||||||
// This is a compile-time assertion to ensure that this generated file
|
|
||||||
// is compatible with the proto package it is being compiled against.
|
|
||||||
const _ = proto.GoGoProtoPackageIsVersion1
|
|
||||||
|
|
||||||
var fileDescriptorGenerated = []byte{
|
|
||||||
// 199 bytes of a gzipped FileDescriptorProto
|
|
||||||
0x1f, 0x8b, 0x08, 0x00, 0x00, 0x09, 0x6e, 0x88, 0x02, 0xff, 0x74, 0xce, 0x2f, 0x4e, 0x05, 0x31,
|
|
||||||
0x10, 0xc7, 0xf1, 0xd6, 0x20, 0x90, 0xc8, 0x27, 0x46, 0x12, 0x0c, 0x1d, 0x81, 0x41, 0x73, 0x01,
|
|
||||||
0x3c, 0xae, 0xbb, 0x6f, 0xe8, 0x36, 0xa5, 0x7f, 0xd2, 0x4e, 0x49, 0x70, 0x1c, 0x81, 0x63, 0xad,
|
|
||||||
0x5c, 0x89, 0x64, 0xcb, 0x45, 0x48, 0xda, 0x15, 0x84, 0x04, 0xd7, 0x5f, 0x9a, 0xcf, 0xe4, 0x7b,
|
|
||||||
0xf9, 0xe8, 0xee, 0x8b, 0xb2, 0x11, 0x5d, 0x9d, 0x28, 0x07, 0x62, 0x2a, 0xf8, 0x4a, 0xe1, 0x1c,
|
|
||||||
0x33, 0x1e, 0x1f, 0x3a, 0x59, 0xaf, 0xe7, 0xc5, 0x06, 0xca, 0x6f, 0x98, 0x9c, 0xc1, 0x5c, 0x03,
|
|
||||||
0x5b, 0x4f, 0x58, 0xe6, 0x85, 0xbc, 0x46, 0x43, 0x81, 0xb2, 0x66, 0x3a, 0xab, 0x94, 0x23, 0xc7,
|
|
||||||
0xab, 0xeb, 0xe1, 0xd4, 0x6f, 0xa7, 0x92, 0x33, 0xea, 0x70, 0x6a, 0xb8, 0xd3, 0xad, 0xb1, 0xbc,
|
|
||||||
0xd4, 0x49, 0xcd, 0xd1, 0xa3, 0x89, 0x26, 0x62, 0xe7, 0x53, 0x7d, 0xee, 0xab, 0x8f, 0xfe, 0x1a,
|
|
||||||
0x67, 0x4f, 0x77, 0xff, 0xe5, 0x54, 0xb6, 0x2f, 0x68, 0x03, 0x17, 0xce, 0x7f, 0x5b, 0x1e, 0x6e,
|
|
||||||
0xd6, 0x1d, 0xc4, 0xb6, 0x83, 0xf8, 0xdc, 0x41, 0xbc, 0x37, 0x90, 0x6b, 0x03, 0xb9, 0x35, 0x90,
|
|
||||||
0x5f, 0x0d, 0xe4, 0xc7, 0x37, 0x88, 0xa7, 0x8b, 0x51, 0xf3, 0x13, 0x00, 0x00, 0xff, 0xff, 0xd9,
|
|
||||||
0x82, 0x09, 0xbe, 0x07, 0x01, 0x00, 0x00,
|
|
||||||
}
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2017 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
|
|
||||||
// This file was autogenerated by go-to-protobuf. Do not edit it manually!
|
|
||||||
|
|
||||||
syntax = 'proto2';
|
|
||||||
|
|
||||||
package k8s.io.apimachinery.pkg.runtime.schema;
|
|
||||||
|
|
||||||
import "k8s.io/apimachinery/pkg/util/intstr/generated.proto";
|
|
||||||
|
|
||||||
// Package-wide variables from generator "generated".
|
|
||||||
option go_package = "schema";
|
|
||||||
|
|
||||||
@@ -1,277 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 schema
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// ParseResourceArg takes the common style of string which may be either `resource.group.com` or `resource.version.group.com`
|
|
||||||
// and parses it out into both possibilities. This code takes no responsibility for knowing which representation was intended
|
|
||||||
// but with a knowledge of all GroupVersions, calling code can take a very good guess. If there are only two segments, then
|
|
||||||
// `*GroupVersionResource` is nil.
|
|
||||||
// `resource.group.com` -> `group=com, version=group, resource=resource` and `group=group.com, resource=resource`
|
|
||||||
func ParseResourceArg(arg string) (*GroupVersionResource, GroupResource) {
|
|
||||||
var gvr *GroupVersionResource
|
|
||||||
if strings.Count(arg, ".") >= 2 {
|
|
||||||
s := strings.SplitN(arg, ".", 3)
|
|
||||||
gvr = &GroupVersionResource{Group: s[2], Version: s[1], Resource: s[0]}
|
|
||||||
}
|
|
||||||
|
|
||||||
return gvr, ParseGroupResource(arg)
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupResource specifies a Group and a Resource, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
type GroupResource struct {
|
|
||||||
Group string
|
|
||||||
Resource string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gr GroupResource) WithVersion(version string) GroupVersionResource {
|
|
||||||
return GroupVersionResource{Group: gr.Group, Version: version, Resource: gr.Resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gr GroupResource) Empty() bool {
|
|
||||||
return len(gr.Group) == 0 && len(gr.Resource) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gr *GroupResource) String() string {
|
|
||||||
if len(gr.Group) == 0 {
|
|
||||||
return gr.Resource
|
|
||||||
}
|
|
||||||
return gr.Resource + "." + gr.Group
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseGroupResource turns "resource.group" string into a GroupResource struct. Empty strings are allowed
|
|
||||||
// for each field.
|
|
||||||
func ParseGroupResource(gr string) GroupResource {
|
|
||||||
if i := strings.Index(gr, "."); i == -1 {
|
|
||||||
return GroupResource{Resource: gr}
|
|
||||||
} else {
|
|
||||||
return GroupResource{Group: gr[i+1:], Resource: gr[:i]}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionResource unambiguously identifies a resource. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coercion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
type GroupVersionResource struct {
|
|
||||||
Group string
|
|
||||||
Version string
|
|
||||||
Resource string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvr GroupVersionResource) Empty() bool {
|
|
||||||
return len(gvr.Group) == 0 && len(gvr.Version) == 0 && len(gvr.Resource) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvr GroupVersionResource) GroupResource() GroupResource {
|
|
||||||
return GroupResource{Group: gvr.Group, Resource: gvr.Resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvr GroupVersionResource) GroupVersion() GroupVersion {
|
|
||||||
return GroupVersion{Group: gvr.Group, Version: gvr.Version}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvr *GroupVersionResource) String() string {
|
|
||||||
return strings.Join([]string{gvr.Group, "/", gvr.Version, ", Resource=", gvr.Resource}, "")
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupKind specifies a Group and a Kind, but does not force a version. This is useful for identifying
|
|
||||||
// concepts during lookup stages without having partially valid types
|
|
||||||
type GroupKind struct {
|
|
||||||
Group string
|
|
||||||
Kind string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gk GroupKind) Empty() bool {
|
|
||||||
return len(gk.Group) == 0 && len(gk.Kind) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gk GroupKind) WithVersion(version string) GroupVersionKind {
|
|
||||||
return GroupVersionKind{Group: gk.Group, Version: version, Kind: gk.Kind}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gk *GroupKind) String() string {
|
|
||||||
if len(gk.Group) == 0 {
|
|
||||||
return gk.Kind
|
|
||||||
}
|
|
||||||
return gk.Kind + "." + gk.Group
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersionKind unambiguously identifies a kind. It doesn't anonymously include GroupVersion
|
|
||||||
// to avoid automatic coercion. It doesn't use a GroupVersion to avoid custom marshalling
|
|
||||||
type GroupVersionKind struct {
|
|
||||||
Group string
|
|
||||||
Version string
|
|
||||||
Kind string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Empty returns true if group, version, and kind are empty
|
|
||||||
func (gvk GroupVersionKind) Empty() bool {
|
|
||||||
return len(gvk.Group) == 0 && len(gvk.Version) == 0 && len(gvk.Kind) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvk GroupVersionKind) GroupKind() GroupKind {
|
|
||||||
return GroupKind{Group: gvk.Group, Kind: gvk.Kind}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvk GroupVersionKind) GroupVersion() GroupVersion {
|
|
||||||
return GroupVersion{Group: gvk.Group, Version: gvk.Version}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (gvk GroupVersionKind) String() string {
|
|
||||||
return gvk.Group + "/" + gvk.Version + ", Kind=" + gvk.Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersion contains the "group" and the "version", which uniquely identifies the API.
|
|
||||||
type GroupVersion struct {
|
|
||||||
Group string
|
|
||||||
Version string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Empty returns true if group and version are empty
|
|
||||||
func (gv GroupVersion) Empty() bool {
|
|
||||||
return len(gv.Group) == 0 && len(gv.Version) == 0
|
|
||||||
}
|
|
||||||
|
|
||||||
// String puts "group" and "version" into a single "group/version" string. For the legacy v1
|
|
||||||
// it returns "v1".
|
|
||||||
func (gv GroupVersion) String() string {
|
|
||||||
// special case the internal apiVersion for the legacy kube types
|
|
||||||
if gv.Empty() {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// special case of "v1" for backward compatibility
|
|
||||||
if len(gv.Group) == 0 && gv.Version == "v1" {
|
|
||||||
return gv.Version
|
|
||||||
}
|
|
||||||
if len(gv.Group) > 0 {
|
|
||||||
return gv.Group + "/" + gv.Version
|
|
||||||
}
|
|
||||||
return gv.Version
|
|
||||||
}
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds identifies the preferred GroupVersionKind out of a list. It returns ok false
|
|
||||||
// if none of the options match the group. It prefers a match to group and version over just group.
|
|
||||||
// TODO: Move GroupVersion to a package under pkg/runtime, since it's used by scheme.
|
|
||||||
// TODO: Introduce an adapter type between GroupVersion and runtime.GroupVersioner, and use LegacyCodec(GroupVersion)
|
|
||||||
// in fewer places.
|
|
||||||
func (gv GroupVersion) KindForGroupVersionKinds(kinds []GroupVersionKind) (target GroupVersionKind, ok bool) {
|
|
||||||
for _, gvk := range kinds {
|
|
||||||
if gvk.Group == gv.Group && gvk.Version == gv.Version {
|
|
||||||
return gvk, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, gvk := range kinds {
|
|
||||||
if gvk.Group == gv.Group {
|
|
||||||
return gv.WithKind(gvk.Kind), true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseGroupVersion turns "group/version" string into a GroupVersion struct. It reports error
|
|
||||||
// if it cannot parse the string.
|
|
||||||
func ParseGroupVersion(gv string) (GroupVersion, error) {
|
|
||||||
// this can be the internal version for the legacy kube types
|
|
||||||
// TODO once we've cleared the last uses as strings, this special case should be removed.
|
|
||||||
if (len(gv) == 0) || (gv == "/") {
|
|
||||||
return GroupVersion{}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
switch strings.Count(gv, "/") {
|
|
||||||
case 0:
|
|
||||||
return GroupVersion{"", gv}, nil
|
|
||||||
case 1:
|
|
||||||
i := strings.Index(gv, "/")
|
|
||||||
return GroupVersion{gv[:i], gv[i+1:]}, nil
|
|
||||||
default:
|
|
||||||
return GroupVersion{}, fmt.Errorf("unexpected GroupVersion string: %v", gv)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithKind creates a GroupVersionKind based on the method receiver's GroupVersion and the passed Kind.
|
|
||||||
func (gv GroupVersion) WithKind(kind string) GroupVersionKind {
|
|
||||||
return GroupVersionKind{Group: gv.Group, Version: gv.Version, Kind: kind}
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithResource creates a GroupVersionResource based on the method receiver's GroupVersion and the passed Resource.
|
|
||||||
func (gv GroupVersion) WithResource(resource string) GroupVersionResource {
|
|
||||||
return GroupVersionResource{Group: gv.Group, Version: gv.Version, Resource: resource}
|
|
||||||
}
|
|
||||||
|
|
||||||
// GroupVersions can be used to represent a set of desired group versions.
|
|
||||||
// TODO: Move GroupVersions to a package under pkg/runtime, since it's used by scheme.
|
|
||||||
// TODO: Introduce an adapter type between GroupVersions and runtime.GroupVersioner, and use LegacyCodec(GroupVersion)
|
|
||||||
// in fewer places.
|
|
||||||
type GroupVersions []GroupVersion
|
|
||||||
|
|
||||||
// KindForGroupVersionKinds identifies the preferred GroupVersionKind out of a list. It returns ok false
|
|
||||||
// if none of the options match the group.
|
|
||||||
func (gvs GroupVersions) KindForGroupVersionKinds(kinds []GroupVersionKind) (GroupVersionKind, bool) {
|
|
||||||
var targets []GroupVersionKind
|
|
||||||
for _, gv := range gvs {
|
|
||||||
target, ok := gv.KindForGroupVersionKinds(kinds)
|
|
||||||
if !ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
targets = append(targets, target)
|
|
||||||
}
|
|
||||||
if len(targets) == 1 {
|
|
||||||
return targets[0], true
|
|
||||||
}
|
|
||||||
if len(targets) > 1 {
|
|
||||||
return bestMatch(kinds, targets), true
|
|
||||||
}
|
|
||||||
return GroupVersionKind{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// bestMatch tries to pick best matching GroupVersionKind and falls back to the first
|
|
||||||
// found if no exact match exists.
|
|
||||||
func bestMatch(kinds []GroupVersionKind, targets []GroupVersionKind) GroupVersionKind {
|
|
||||||
for _, gvk := range targets {
|
|
||||||
for _, k := range kinds {
|
|
||||||
if k == gvk {
|
|
||||||
return k
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return targets[0]
|
|
||||||
}
|
|
||||||
|
|
||||||
// ToAPIVersionAndKind is a convenience method for satisfying runtime.Object on types that
|
|
||||||
// do not use TypeMeta.
|
|
||||||
func (gvk *GroupVersionKind) ToAPIVersionAndKind() (string, string) {
|
|
||||||
if gvk == nil {
|
|
||||||
return "", ""
|
|
||||||
}
|
|
||||||
return gvk.GroupVersion().String(), gvk.Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// FromAPIVersionAndKind returns a GVK representing the provided fields for types that
|
|
||||||
// do not use TypeMeta. This method exists to support test types and legacy serializations
|
|
||||||
// that have a distinct group and kind.
|
|
||||||
// TODO: further reduce usage of this method.
|
|
||||||
func FromAPIVersionAndKind(apiVersion, kind string) GroupVersionKind {
|
|
||||||
if gv, err := ParseGroupVersion(apiVersion); err == nil {
|
|
||||||
return GroupVersionKind{Group: gv.Group, Version: gv.Version, Kind: kind}
|
|
||||||
}
|
|
||||||
return GroupVersionKind{Kind: kind}
|
|
||||||
}
|
|
||||||
@@ -1,40 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2016 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 schema
|
|
||||||
|
|
||||||
// All objects that are serialized from a Scheme encode their type information. This interface is used
|
|
||||||
// by serialization to set type information from the Scheme onto the serialized version of an object.
|
|
||||||
// For objects that cannot be serialized or have unique requirements, this interface may be a no-op.
|
|
||||||
type ObjectKind interface {
|
|
||||||
// SetGroupVersionKind sets or clears the intended serialized kind of an object. Passing kind nil
|
|
||||||
// should clear the current setting.
|
|
||||||
SetGroupVersionKind(kind GroupVersionKind)
|
|
||||||
// GroupVersionKind returns the stored group, version, and kind of an object, or nil if the object does
|
|
||||||
// not expose or provide these fields.
|
|
||||||
GroupVersionKind() GroupVersionKind
|
|
||||||
}
|
|
||||||
|
|
||||||
// EmptyObjectKind implements the ObjectKind interface as a noop
|
|
||||||
var EmptyObjectKind = emptyObjectKind{}
|
|
||||||
|
|
||||||
type emptyObjectKind struct{}
|
|
||||||
|
|
||||||
// SetGroupVersionKind implements the ObjectKind interface
|
|
||||||
func (emptyObjectKind) SetGroupVersionKind(gvk GroupVersionKind) {}
|
|
||||||
|
|
||||||
// GroupVersionKind implements the ObjectKind interface
|
|
||||||
func (emptyObjectKind) GroupVersionKind() GroupVersionKind { return GroupVersionKind{} }
|
|
||||||
@@ -1,600 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 runtime
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/url"
|
|
||||||
"reflect"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/conversion"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Scheme defines methods for serializing and deserializing API objects, a type
|
|
||||||
// registry for converting group, version, and kind information to and from Go
|
|
||||||
// schemas, and mappings between Go schemas of different versions. A scheme is the
|
|
||||||
// foundation for a versioned API and versioned configuration over time.
|
|
||||||
//
|
|
||||||
// In a Scheme, a Type is a particular Go struct, a Version is a point-in-time
|
|
||||||
// identifier for a particular representation of that Type (typically backwards
|
|
||||||
// compatible), a Kind is the unique name for that Type within the Version, and a
|
|
||||||
// Group identifies a set of Versions, Kinds, and Types that evolve over time. An
|
|
||||||
// Unversioned Type is one that is not yet formally bound to a type and is promised
|
|
||||||
// to be backwards compatible (effectively a "v1" of a Type that does not expect
|
|
||||||
// to break in the future).
|
|
||||||
//
|
|
||||||
// Schemes are not expected to change at runtime and are only threadsafe after
|
|
||||||
// registration is complete.
|
|
||||||
type Scheme struct {
|
|
||||||
// versionMap allows one to figure out the go type of an object with
|
|
||||||
// the given version and name.
|
|
||||||
gvkToType map[schema.GroupVersionKind]reflect.Type
|
|
||||||
|
|
||||||
// typeToGroupVersion allows one to find metadata for a given go object.
|
|
||||||
// The reflect.Type we index by should *not* be a pointer.
|
|
||||||
typeToGVK map[reflect.Type][]schema.GroupVersionKind
|
|
||||||
|
|
||||||
// unversionedTypes are transformed without conversion in ConvertToVersion.
|
|
||||||
unversionedTypes map[reflect.Type]schema.GroupVersionKind
|
|
||||||
|
|
||||||
// unversionedKinds are the names of kinds that can be created in the context of any group
|
|
||||||
// or version
|
|
||||||
// TODO: resolve the status of unversioned types.
|
|
||||||
unversionedKinds map[string]reflect.Type
|
|
||||||
|
|
||||||
// Map from version and resource to the corresponding func to convert
|
|
||||||
// resource field labels in that version to internal version.
|
|
||||||
fieldLabelConversionFuncs map[string]map[string]FieldLabelConversionFunc
|
|
||||||
|
|
||||||
// defaulterFuncs is an array of interfaces to be called with an object to provide defaulting
|
|
||||||
// the provided object must be a pointer.
|
|
||||||
defaulterFuncs map[reflect.Type]func(interface{})
|
|
||||||
|
|
||||||
// converter stores all registered conversion functions. It also has
|
|
||||||
// default coverting behavior.
|
|
||||||
converter *conversion.Converter
|
|
||||||
|
|
||||||
// cloner stores all registered copy functions. It also has default
|
|
||||||
// deep copy behavior.
|
|
||||||
cloner *conversion.Cloner
|
|
||||||
}
|
|
||||||
|
|
||||||
// Function to convert a field selector to internal representation.
|
|
||||||
type FieldLabelConversionFunc func(label, value string) (internalLabel, internalValue string, err error)
|
|
||||||
|
|
||||||
// NewScheme creates a new Scheme. This scheme is pluggable by default.
|
|
||||||
func NewScheme() *Scheme {
|
|
||||||
s := &Scheme{
|
|
||||||
gvkToType: map[schema.GroupVersionKind]reflect.Type{},
|
|
||||||
typeToGVK: map[reflect.Type][]schema.GroupVersionKind{},
|
|
||||||
unversionedTypes: map[reflect.Type]schema.GroupVersionKind{},
|
|
||||||
unversionedKinds: map[string]reflect.Type{},
|
|
||||||
cloner: conversion.NewCloner(),
|
|
||||||
fieldLabelConversionFuncs: map[string]map[string]FieldLabelConversionFunc{},
|
|
||||||
defaulterFuncs: map[reflect.Type]func(interface{}){},
|
|
||||||
}
|
|
||||||
s.converter = conversion.NewConverter(s.nameFunc)
|
|
||||||
|
|
||||||
s.AddConversionFuncs(DefaultEmbeddedConversions()...)
|
|
||||||
|
|
||||||
// Enable map[string][]string conversions by default
|
|
||||||
if err := s.AddConversionFuncs(DefaultStringConversions...); err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
if err := s.RegisterInputDefaults(&map[string][]string{}, JSONKeyMapper, conversion.AllowDifferentFieldTypeNames|conversion.IgnoreMissingFields); err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
if err := s.RegisterInputDefaults(&url.Values{}, JSONKeyMapper, conversion.AllowDifferentFieldTypeNames|conversion.IgnoreMissingFields); err != nil {
|
|
||||||
panic(err)
|
|
||||||
}
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
|
|
||||||
// nameFunc returns the name of the type that we wish to use to determine when two types attempt
|
|
||||||
// a conversion. Defaults to the go name of the type if the type is not registered.
|
|
||||||
func (s *Scheme) nameFunc(t reflect.Type) string {
|
|
||||||
// find the preferred names for this type
|
|
||||||
gvks, ok := s.typeToGVK[t]
|
|
||||||
if !ok {
|
|
||||||
return t.Name()
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, gvk := range gvks {
|
|
||||||
internalGV := gvk.GroupVersion()
|
|
||||||
internalGV.Version = "__internal" // this is hacky and maybe should be passed in
|
|
||||||
internalGVK := internalGV.WithKind(gvk.Kind)
|
|
||||||
|
|
||||||
if internalType, exists := s.gvkToType[internalGVK]; exists {
|
|
||||||
return s.typeToGVK[internalType][0].Kind
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return gvks[0].Kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// fromScope gets the input version, desired output version, and desired Scheme
|
|
||||||
// from a conversion.Scope.
|
|
||||||
func (s *Scheme) fromScope(scope conversion.Scope) *Scheme {
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
|
|
||||||
// Converter allows access to the converter for the scheme
|
|
||||||
func (s *Scheme) Converter() *conversion.Converter {
|
|
||||||
return s.converter
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddUnversionedTypes registers the provided types as "unversioned", which means that they follow special rules.
|
|
||||||
// Whenever an object of this type is serialized, it is serialized with the provided group version and is not
|
|
||||||
// converted. Thus unversioned objects are expected to remain backwards compatible forever, as if they were in an
|
|
||||||
// API group and version that would never be updated.
|
|
||||||
//
|
|
||||||
// TODO: there is discussion about removing unversioned and replacing it with objects that are manifest into
|
|
||||||
// every version with particular schemas. Resolve this method at that point.
|
|
||||||
func (s *Scheme) AddUnversionedTypes(version schema.GroupVersion, types ...Object) {
|
|
||||||
s.AddKnownTypes(version, types...)
|
|
||||||
for _, obj := range types {
|
|
||||||
t := reflect.TypeOf(obj).Elem()
|
|
||||||
gvk := version.WithKind(t.Name())
|
|
||||||
s.unversionedTypes[t] = gvk
|
|
||||||
if _, ok := s.unversionedKinds[gvk.Kind]; ok {
|
|
||||||
panic(fmt.Sprintf("%v has already been registered as unversioned kind %q - kind name must be unique", reflect.TypeOf(t), gvk.Kind))
|
|
||||||
}
|
|
||||||
s.unversionedKinds[gvk.Kind] = t
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddKnownTypes registers all types passed in 'types' as being members of version 'version'.
|
|
||||||
// All objects passed to types should be pointers to structs. The name that go reports for
|
|
||||||
// the struct becomes the "kind" field when encoding. Version may not be empty - use the
|
|
||||||
// APIVersionInternal constant if you have a type that does not have a formal version.
|
|
||||||
func (s *Scheme) AddKnownTypes(gv schema.GroupVersion, types ...Object) {
|
|
||||||
if len(gv.Version) == 0 {
|
|
||||||
panic(fmt.Sprintf("version is required on all types: %s %v", gv, types[0]))
|
|
||||||
}
|
|
||||||
for _, obj := range types {
|
|
||||||
t := reflect.TypeOf(obj)
|
|
||||||
if t.Kind() != reflect.Ptr {
|
|
||||||
panic("All types must be pointers to structs.")
|
|
||||||
}
|
|
||||||
t = t.Elem()
|
|
||||||
if t.Kind() != reflect.Struct {
|
|
||||||
panic("All types must be pointers to structs.")
|
|
||||||
}
|
|
||||||
|
|
||||||
gvk := gv.WithKind(t.Name())
|
|
||||||
s.gvkToType[gvk] = t
|
|
||||||
s.typeToGVK[t] = append(s.typeToGVK[t], gvk)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddKnownTypeWithName is like AddKnownTypes, but it lets you specify what this type should
|
|
||||||
// be encoded as. Useful for testing when you don't want to make multiple packages to define
|
|
||||||
// your structs. Version may not be empty - use the APIVersionInternal constant if you have a
|
|
||||||
// type that does not have a formal version.
|
|
||||||
func (s *Scheme) AddKnownTypeWithName(gvk schema.GroupVersionKind, obj Object) {
|
|
||||||
t := reflect.TypeOf(obj)
|
|
||||||
if len(gvk.Version) == 0 {
|
|
||||||
panic(fmt.Sprintf("version is required on all types: %s %v", gvk, t))
|
|
||||||
}
|
|
||||||
if t.Kind() != reflect.Ptr {
|
|
||||||
panic("All types must be pointers to structs.")
|
|
||||||
}
|
|
||||||
t = t.Elem()
|
|
||||||
if t.Kind() != reflect.Struct {
|
|
||||||
panic("All types must be pointers to structs.")
|
|
||||||
}
|
|
||||||
|
|
||||||
s.gvkToType[gvk] = t
|
|
||||||
s.typeToGVK[t] = append(s.typeToGVK[t], gvk)
|
|
||||||
}
|
|
||||||
|
|
||||||
// KnownTypes returns the types known for the given version.
|
|
||||||
func (s *Scheme) KnownTypes(gv schema.GroupVersion) map[string]reflect.Type {
|
|
||||||
types := make(map[string]reflect.Type)
|
|
||||||
for gvk, t := range s.gvkToType {
|
|
||||||
if gv != gvk.GroupVersion() {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
types[gvk.Kind] = t
|
|
||||||
}
|
|
||||||
return types
|
|
||||||
}
|
|
||||||
|
|
||||||
// AllKnownTypes returns the all known types.
|
|
||||||
func (s *Scheme) AllKnownTypes() map[schema.GroupVersionKind]reflect.Type {
|
|
||||||
return s.gvkToType
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectKind returns the group,version,kind of the go object and true if this object
|
|
||||||
// is considered unversioned, or an error if it's not a pointer or is unregistered.
|
|
||||||
func (s *Scheme) ObjectKind(obj Object) (schema.GroupVersionKind, bool, error) {
|
|
||||||
gvks, unversionedType, err := s.ObjectKinds(obj)
|
|
||||||
if err != nil {
|
|
||||||
return schema.GroupVersionKind{}, false, err
|
|
||||||
}
|
|
||||||
return gvks[0], unversionedType, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// ObjectKinds returns all possible group,version,kind of the go object, true if the
|
|
||||||
// object is considered unversioned, or an error if it's not a pointer or is unregistered.
|
|
||||||
func (s *Scheme) ObjectKinds(obj Object) ([]schema.GroupVersionKind, bool, error) {
|
|
||||||
v, err := conversion.EnforcePtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, false, err
|
|
||||||
}
|
|
||||||
t := v.Type()
|
|
||||||
|
|
||||||
gvks, ok := s.typeToGVK[t]
|
|
||||||
if !ok {
|
|
||||||
return nil, false, NewNotRegisteredErr(schema.GroupVersionKind{}, t)
|
|
||||||
}
|
|
||||||
_, unversionedType := s.unversionedTypes[t]
|
|
||||||
|
|
||||||
return gvks, unversionedType, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Recognizes returns true if the scheme is able to handle the provided group,version,kind
|
|
||||||
// of an object.
|
|
||||||
func (s *Scheme) Recognizes(gvk schema.GroupVersionKind) bool {
|
|
||||||
_, exists := s.gvkToType[gvk]
|
|
||||||
return exists
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s *Scheme) IsUnversioned(obj Object) (bool, bool) {
|
|
||||||
v, err := conversion.EnforcePtr(obj)
|
|
||||||
if err != nil {
|
|
||||||
return false, false
|
|
||||||
}
|
|
||||||
t := v.Type()
|
|
||||||
|
|
||||||
if _, ok := s.typeToGVK[t]; !ok {
|
|
||||||
return false, false
|
|
||||||
}
|
|
||||||
_, ok := s.unversionedTypes[t]
|
|
||||||
return ok, true
|
|
||||||
}
|
|
||||||
|
|
||||||
// New returns a new API object of the given version and name, or an error if it hasn't
|
|
||||||
// been registered. The version and kind fields must be specified.
|
|
||||||
func (s *Scheme) New(kind schema.GroupVersionKind) (Object, error) {
|
|
||||||
if t, exists := s.gvkToType[kind]; exists {
|
|
||||||
return reflect.New(t).Interface().(Object), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
if t, exists := s.unversionedKinds[kind.Kind]; exists {
|
|
||||||
return reflect.New(t).Interface().(Object), nil
|
|
||||||
}
|
|
||||||
return nil, NewNotRegisteredErr(kind, nil)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddGenericConversionFunc adds a function that accepts the ConversionFunc call pattern
|
|
||||||
// (for two conversion types) to the converter. These functions are checked first during
|
|
||||||
// a normal conversion, but are otherwise not called. Use AddConversionFuncs when registering
|
|
||||||
// typed conversions.
|
|
||||||
func (s *Scheme) AddGenericConversionFunc(fn conversion.GenericConversionFunc) {
|
|
||||||
s.converter.AddGenericConversionFunc(fn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Log sets a logger on the scheme. For test purposes only
|
|
||||||
func (s *Scheme) Log(l conversion.DebugLogger) {
|
|
||||||
s.converter.Debug = l
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddIgnoredConversionType identifies a pair of types that should be skipped by
|
|
||||||
// conversion (because the data inside them is explicitly dropped during
|
|
||||||
// conversion).
|
|
||||||
func (s *Scheme) AddIgnoredConversionType(from, to interface{}) error {
|
|
||||||
return s.converter.RegisterIgnoredConversion(from, to)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddConversionFuncs adds functions to the list of conversion functions. The given
|
|
||||||
// functions should know how to convert between two of your API objects, or their
|
|
||||||
// sub-objects. We deduce how to call these functions from the types of their two
|
|
||||||
// parameters; see the comment for Converter.Register.
|
|
||||||
//
|
|
||||||
// Note that, if you need to copy sub-objects that didn't change, you can use the
|
|
||||||
// conversion.Scope object that will be passed to your conversion function.
|
|
||||||
// Additionally, all conversions started by Scheme will set the SrcVersion and
|
|
||||||
// DestVersion fields on the Meta object. Example:
|
|
||||||
//
|
|
||||||
// s.AddConversionFuncs(
|
|
||||||
// func(in *InternalObject, out *ExternalObject, scope conversion.Scope) error {
|
|
||||||
// // You can depend on Meta() being non-nil, and this being set to
|
|
||||||
// // the source version, e.g., ""
|
|
||||||
// s.Meta().SrcVersion
|
|
||||||
// // You can depend on this being set to the destination version,
|
|
||||||
// // e.g., "v1".
|
|
||||||
// s.Meta().DestVersion
|
|
||||||
// // Call scope.Convert to copy sub-fields.
|
|
||||||
// s.Convert(&in.SubFieldThatMoved, &out.NewLocation.NewName, 0)
|
|
||||||
// return nil
|
|
||||||
// },
|
|
||||||
// )
|
|
||||||
//
|
|
||||||
// (For more detail about conversion functions, see Converter.Register's comment.)
|
|
||||||
//
|
|
||||||
// Also note that the default behavior, if you don't add a conversion function, is to
|
|
||||||
// sanely copy fields that have the same names and same type names. It's OK if the
|
|
||||||
// destination type has extra fields, but it must not remove any. So you only need to
|
|
||||||
// add conversion functions for things with changed/removed fields.
|
|
||||||
func (s *Scheme) AddConversionFuncs(conversionFuncs ...interface{}) error {
|
|
||||||
for _, f := range conversionFuncs {
|
|
||||||
if err := s.converter.RegisterConversionFunc(f); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Similar to AddConversionFuncs, but registers conversion functions that were
|
|
||||||
// automatically generated.
|
|
||||||
func (s *Scheme) AddGeneratedConversionFuncs(conversionFuncs ...interface{}) error {
|
|
||||||
for _, f := range conversionFuncs {
|
|
||||||
if err := s.converter.RegisterGeneratedConversionFunc(f); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddDeepCopyFuncs adds a function to the list of deep-copy functions.
|
|
||||||
// For the expected format of deep-copy function, see the comment for
|
|
||||||
// Copier.RegisterDeepCopyFunction.
|
|
||||||
func (s *Scheme) AddDeepCopyFuncs(deepCopyFuncs ...interface{}) error {
|
|
||||||
for _, f := range deepCopyFuncs {
|
|
||||||
if err := s.cloner.RegisterDeepCopyFunc(f); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Similar to AddDeepCopyFuncs, but registers deep-copy functions that were
|
|
||||||
// automatically generated.
|
|
||||||
func (s *Scheme) AddGeneratedDeepCopyFuncs(deepCopyFuncs ...conversion.GeneratedDeepCopyFunc) error {
|
|
||||||
for _, fn := range deepCopyFuncs {
|
|
||||||
if err := s.cloner.RegisterGeneratedDeepCopyFunc(fn); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddFieldLabelConversionFunc adds a conversion function to convert field selectors
|
|
||||||
// of the given kind from the given version to internal version representation.
|
|
||||||
func (s *Scheme) AddFieldLabelConversionFunc(version, kind string, conversionFunc FieldLabelConversionFunc) error {
|
|
||||||
if s.fieldLabelConversionFuncs[version] == nil {
|
|
||||||
s.fieldLabelConversionFuncs[version] = map[string]FieldLabelConversionFunc{}
|
|
||||||
}
|
|
||||||
|
|
||||||
s.fieldLabelConversionFuncs[version][kind] = conversionFunc
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddStructFieldConversion allows you to specify a mechanical copy for a moved
|
|
||||||
// or renamed struct field without writing an entire conversion function. See
|
|
||||||
// the comment in conversion.Converter.SetStructFieldCopy for parameter details.
|
|
||||||
// Call as many times as needed, even on the same fields.
|
|
||||||
func (s *Scheme) AddStructFieldConversion(srcFieldType interface{}, srcFieldName string, destFieldType interface{}, destFieldName string) error {
|
|
||||||
return s.converter.SetStructFieldCopy(srcFieldType, srcFieldName, destFieldType, destFieldName)
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterInputDefaults sets the provided field mapping function and field matching
|
|
||||||
// as the defaults for the provided input type. The fn may be nil, in which case no
|
|
||||||
// mapping will happen by default. Use this method to register a mechanism for handling
|
|
||||||
// a specific input type in conversion, such as a map[string]string to structs.
|
|
||||||
func (s *Scheme) RegisterInputDefaults(in interface{}, fn conversion.FieldMappingFunc, defaultFlags conversion.FieldMatchingFlags) error {
|
|
||||||
return s.converter.RegisterInputDefaults(in, fn, defaultFlags)
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddDefaultingFuncs adds functions to the list of default-value functions.
|
|
||||||
// Each of the given functions is responsible for applying default values
|
|
||||||
// when converting an instance of a versioned API object into an internal
|
|
||||||
// API object. These functions do not need to handle sub-objects. We deduce
|
|
||||||
// how to call these functions from the types of their two parameters.
|
|
||||||
//
|
|
||||||
// s.AddDefaultingFuncs(
|
|
||||||
// func(obj *v1.Pod) {
|
|
||||||
// if obj.OptionalField == "" {
|
|
||||||
// obj.OptionalField = "DefaultValue"
|
|
||||||
// }
|
|
||||||
// },
|
|
||||||
// )
|
|
||||||
func (s *Scheme) AddDefaultingFuncs(defaultingFuncs ...interface{}) error {
|
|
||||||
for _, f := range defaultingFuncs {
|
|
||||||
err := s.converter.RegisterDefaultingFunc(f)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddTypeDefaultingFuncs registers a function that is passed a pointer to an
|
|
||||||
// object and can default fields on the object. These functions will be invoked
|
|
||||||
// when Default() is called. The function will never be called unless the
|
|
||||||
// defaulted object matches srcType. If this function is invoked twice with the
|
|
||||||
// same srcType, the fn passed to the later call will be used instead.
|
|
||||||
func (s *Scheme) AddTypeDefaultingFunc(srcType Object, fn func(interface{})) {
|
|
||||||
s.defaulterFuncs[reflect.TypeOf(srcType)] = fn
|
|
||||||
}
|
|
||||||
|
|
||||||
// Default sets defaults on the provided Object.
|
|
||||||
func (s *Scheme) Default(src Object) {
|
|
||||||
if fn, ok := s.defaulterFuncs[reflect.TypeOf(src)]; ok {
|
|
||||||
fn(src)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Copy does a deep copy of an API object.
|
|
||||||
func (s *Scheme) Copy(src Object) (Object, error) {
|
|
||||||
dst, err := s.DeepCopy(src)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return dst.(Object), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Performs a deep copy of the given object.
|
|
||||||
func (s *Scheme) DeepCopy(src interface{}) (interface{}, error) {
|
|
||||||
return s.cloner.DeepCopy(src)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Convert will attempt to convert in into out. Both must be pointers. For easy
|
|
||||||
// testing of conversion functions. Returns an error if the conversion isn't
|
|
||||||
// possible. You can call this with types that haven't been registered (for example,
|
|
||||||
// a to test conversion of types that are nested within registered types). The
|
|
||||||
// context interface is passed to the convertor.
|
|
||||||
// TODO: identify whether context should be hidden, or behind a formal context/scope
|
|
||||||
// interface
|
|
||||||
func (s *Scheme) Convert(in, out interface{}, context interface{}) error {
|
|
||||||
flags, meta := s.generateConvertMeta(in)
|
|
||||||
meta.Context = context
|
|
||||||
if flags == 0 {
|
|
||||||
flags = conversion.AllowDifferentFieldTypeNames
|
|
||||||
}
|
|
||||||
return s.converter.Convert(in, out, flags, meta)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Converts the given field label and value for an kind field selector from
|
|
||||||
// versioned representation to an unversioned one.
|
|
||||||
func (s *Scheme) ConvertFieldLabel(version, kind, label, value string) (string, string, error) {
|
|
||||||
if s.fieldLabelConversionFuncs[version] == nil {
|
|
||||||
return "", "", fmt.Errorf("No field label conversion function found for version: %s", version)
|
|
||||||
}
|
|
||||||
conversionFunc, ok := s.fieldLabelConversionFuncs[version][kind]
|
|
||||||
if !ok {
|
|
||||||
return "", "", fmt.Errorf("No field label conversion function found for version %s and kind %s", version, kind)
|
|
||||||
}
|
|
||||||
return conversionFunc(label, value)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ConvertToVersion attempts to convert an input object to its matching Kind in another
|
|
||||||
// version within this scheme. Will return an error if the provided version does not
|
|
||||||
// contain the inKind (or a mapping by name defined with AddKnownTypeWithName). Will also
|
|
||||||
// return an error if the conversion does not result in a valid Object being
|
|
||||||
// returned. Passes target down to the conversion methods as the Context on the scope.
|
|
||||||
func (s *Scheme) ConvertToVersion(in Object, target GroupVersioner) (Object, error) {
|
|
||||||
return s.convertToVersion(true, in, target)
|
|
||||||
}
|
|
||||||
|
|
||||||
// UnsafeConvertToVersion will convert in to the provided target if such a conversion is possible,
|
|
||||||
// but does not guarantee the output object does not share fields with the input object. It attempts to be as
|
|
||||||
// efficient as possible when doing conversion.
|
|
||||||
func (s *Scheme) UnsafeConvertToVersion(in Object, target GroupVersioner) (Object, error) {
|
|
||||||
return s.convertToVersion(false, in, target)
|
|
||||||
}
|
|
||||||
|
|
||||||
// convertToVersion handles conversion with an optional copy.
|
|
||||||
func (s *Scheme) convertToVersion(copy bool, in Object, target GroupVersioner) (Object, error) {
|
|
||||||
// determine the incoming kinds with as few allocations as possible.
|
|
||||||
t := reflect.TypeOf(in)
|
|
||||||
if t.Kind() != reflect.Ptr {
|
|
||||||
return nil, fmt.Errorf("only pointer types may be converted: %v", t)
|
|
||||||
}
|
|
||||||
t = t.Elem()
|
|
||||||
if t.Kind() != reflect.Struct {
|
|
||||||
return nil, fmt.Errorf("only pointers to struct types may be converted: %v", t)
|
|
||||||
}
|
|
||||||
kinds, ok := s.typeToGVK[t]
|
|
||||||
if !ok || len(kinds) == 0 {
|
|
||||||
return nil, NewNotRegisteredErr(schema.GroupVersionKind{}, t)
|
|
||||||
}
|
|
||||||
|
|
||||||
gvk, ok := target.KindForGroupVersionKinds(kinds)
|
|
||||||
if !ok {
|
|
||||||
// try to see if this type is listed as unversioned (for legacy support)
|
|
||||||
// TODO: when we move to server API versions, we should completely remove the unversioned concept
|
|
||||||
if unversionedKind, ok := s.unversionedTypes[t]; ok {
|
|
||||||
if gvk, ok := target.KindForGroupVersionKinds([]schema.GroupVersionKind{unversionedKind}); ok {
|
|
||||||
return copyAndSetTargetKind(copy, s, in, gvk)
|
|
||||||
}
|
|
||||||
return copyAndSetTargetKind(copy, s, in, unversionedKind)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TODO: should this be a typed error?
|
|
||||||
return nil, fmt.Errorf("%v is not suitable for converting to %q", t, target)
|
|
||||||
}
|
|
||||||
|
|
||||||
// target wants to use the existing type, set kind and return (no conversion necessary)
|
|
||||||
for _, kind := range kinds {
|
|
||||||
if gvk == kind {
|
|
||||||
return copyAndSetTargetKind(copy, s, in, gvk)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// type is unversioned, no conversion necessary
|
|
||||||
if unversionedKind, ok := s.unversionedTypes[t]; ok {
|
|
||||||
if gvk, ok := target.KindForGroupVersionKinds([]schema.GroupVersionKind{unversionedKind}); ok {
|
|
||||||
return copyAndSetTargetKind(copy, s, in, gvk)
|
|
||||||
}
|
|
||||||
return copyAndSetTargetKind(copy, s, in, unversionedKind)
|
|
||||||
}
|
|
||||||
|
|
||||||
out, err := s.New(gvk)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
if copy {
|
|
||||||
copied, err := s.Copy(in)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
in = copied
|
|
||||||
}
|
|
||||||
|
|
||||||
flags, meta := s.generateConvertMeta(in)
|
|
||||||
meta.Context = target
|
|
||||||
if err := s.converter.Convert(in, out, flags, meta); err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
setTargetKind(out, gvk)
|
|
||||||
return out, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// generateConvertMeta constructs the meta value we pass to Convert.
|
|
||||||
func (s *Scheme) generateConvertMeta(in interface{}) (conversion.FieldMatchingFlags, *conversion.Meta) {
|
|
||||||
return s.converter.DefaultMeta(reflect.TypeOf(in))
|
|
||||||
}
|
|
||||||
|
|
||||||
// copyAndSetTargetKind performs a conditional copy before returning the object, or an error if copy was not successful.
|
|
||||||
func copyAndSetTargetKind(copy bool, copier ObjectCopier, obj Object, kind schema.GroupVersionKind) (Object, error) {
|
|
||||||
if copy {
|
|
||||||
copied, err := copier.Copy(obj)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
obj = copied
|
|
||||||
}
|
|
||||||
setTargetKind(obj, kind)
|
|
||||||
return obj, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// setTargetKind sets the kind on an object, taking into account whether the target kind is the internal version.
|
|
||||||
func setTargetKind(obj Object, kind schema.GroupVersionKind) {
|
|
||||||
if kind.Version == APIVersionInternal {
|
|
||||||
// internal is a special case
|
|
||||||
// TODO: look at removing the need to special case this
|
|
||||||
obj.GetObjectKind().SetGroupVersionKind(schema.GroupVersionKind{})
|
|
||||||
return
|
|
||||||
}
|
|
||||||
obj.GetObjectKind().SetGroupVersionKind(kind)
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2015 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 runtime
|
|
||||||
|
|
||||||
// SchemeBuilder collects functions that add things to a scheme. It's to allow
|
|
||||||
// code to compile without explicitly referencing generated types. You should
|
|
||||||
// declare one in each package that will have generated deep copy or conversion
|
|
||||||
// functions.
|
|
||||||
type SchemeBuilder []func(*Scheme) error
|
|
||||||
|
|
||||||
// AddToScheme applies all the stored functions to the scheme. A non-nil error
|
|
||||||
// indicates that one function failed and the attempt was abandoned.
|
|
||||||
func (sb *SchemeBuilder) AddToScheme(s *Scheme) error {
|
|
||||||
for _, f := range *sb {
|
|
||||||
if err := f(s); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Register adds a scheme setup function to the list.
|
|
||||||
func (sb *SchemeBuilder) Register(funcs ...func(*Scheme) error) {
|
|
||||||
for _, f := range funcs {
|
|
||||||
*sb = append(*sb, f)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewSchemeBuilder calls Register for you.
|
|
||||||
func NewSchemeBuilder(funcs ...func(*Scheme) error) SchemeBuilder {
|
|
||||||
var sb SchemeBuilder
|
|
||||||
sb.Register(funcs...)
|
|
||||||
return sb
|
|
||||||
}
|
|
||||||
@@ -1,237 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 serializer
|
|
||||||
|
|
||||||
import (
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/serializer/json"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/serializer/recognizer"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/serializer/versioning"
|
|
||||||
)
|
|
||||||
|
|
||||||
// serializerExtensions are for serializers that are conditionally compiled in
|
|
||||||
var serializerExtensions = []func(*runtime.Scheme) (serializerType, bool){}
|
|
||||||
|
|
||||||
type serializerType struct {
|
|
||||||
AcceptContentTypes []string
|
|
||||||
ContentType string
|
|
||||||
FileExtensions []string
|
|
||||||
// EncodesAsText should be true if this content type can be represented safely in UTF-8
|
|
||||||
EncodesAsText bool
|
|
||||||
|
|
||||||
Serializer runtime.Serializer
|
|
||||||
PrettySerializer runtime.Serializer
|
|
||||||
|
|
||||||
AcceptStreamContentTypes []string
|
|
||||||
StreamContentType string
|
|
||||||
|
|
||||||
Framer runtime.Framer
|
|
||||||
StreamSerializer runtime.Serializer
|
|
||||||
}
|
|
||||||
|
|
||||||
func newSerializersForScheme(scheme *runtime.Scheme, mf json.MetaFactory) []serializerType {
|
|
||||||
jsonSerializer := json.NewSerializer(mf, scheme, scheme, false)
|
|
||||||
jsonPrettySerializer := json.NewSerializer(mf, scheme, scheme, true)
|
|
||||||
yamlSerializer := json.NewYAMLSerializer(mf, scheme, scheme)
|
|
||||||
|
|
||||||
serializers := []serializerType{
|
|
||||||
{
|
|
||||||
AcceptContentTypes: []string{"application/json"},
|
|
||||||
ContentType: "application/json",
|
|
||||||
FileExtensions: []string{"json"},
|
|
||||||
EncodesAsText: true,
|
|
||||||
Serializer: jsonSerializer,
|
|
||||||
PrettySerializer: jsonPrettySerializer,
|
|
||||||
|
|
||||||
Framer: json.Framer,
|
|
||||||
StreamSerializer: jsonSerializer,
|
|
||||||
},
|
|
||||||
{
|
|
||||||
AcceptContentTypes: []string{"application/yaml"},
|
|
||||||
ContentType: "application/yaml",
|
|
||||||
FileExtensions: []string{"yaml"},
|
|
||||||
EncodesAsText: true,
|
|
||||||
Serializer: yamlSerializer,
|
|
||||||
},
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, fn := range serializerExtensions {
|
|
||||||
if serializer, ok := fn(scheme); ok {
|
|
||||||
serializers = append(serializers, serializer)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return serializers
|
|
||||||
}
|
|
||||||
|
|
||||||
// CodecFactory provides methods for retrieving codecs and serializers for specific
|
|
||||||
// versions and content types.
|
|
||||||
type CodecFactory struct {
|
|
||||||
scheme *runtime.Scheme
|
|
||||||
serializers []serializerType
|
|
||||||
universal runtime.Decoder
|
|
||||||
accepts []runtime.SerializerInfo
|
|
||||||
|
|
||||||
legacySerializer runtime.Serializer
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewCodecFactory provides methods for retrieving serializers for the supported wire formats
|
|
||||||
// and conversion wrappers to define preferred internal and external versions. In the future,
|
|
||||||
// as the internal version is used less, callers may instead use a defaulting serializer and
|
|
||||||
// only convert objects which are shared internally (Status, common API machinery).
|
|
||||||
// TODO: allow other codecs to be compiled in?
|
|
||||||
// TODO: accept a scheme interface
|
|
||||||
func NewCodecFactory(scheme *runtime.Scheme) CodecFactory {
|
|
||||||
serializers := newSerializersForScheme(scheme, json.DefaultMetaFactory)
|
|
||||||
return newCodecFactory(scheme, serializers)
|
|
||||||
}
|
|
||||||
|
|
||||||
// newCodecFactory is a helper for testing that allows a different metafactory to be specified.
|
|
||||||
func newCodecFactory(scheme *runtime.Scheme, serializers []serializerType) CodecFactory {
|
|
||||||
decoders := make([]runtime.Decoder, 0, len(serializers))
|
|
||||||
var accepts []runtime.SerializerInfo
|
|
||||||
alreadyAccepted := make(map[string]struct{})
|
|
||||||
|
|
||||||
var legacySerializer runtime.Serializer
|
|
||||||
for _, d := range serializers {
|
|
||||||
decoders = append(decoders, d.Serializer)
|
|
||||||
for _, mediaType := range d.AcceptContentTypes {
|
|
||||||
if _, ok := alreadyAccepted[mediaType]; ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
alreadyAccepted[mediaType] = struct{}{}
|
|
||||||
info := runtime.SerializerInfo{
|
|
||||||
MediaType: d.ContentType,
|
|
||||||
EncodesAsText: d.EncodesAsText,
|
|
||||||
Serializer: d.Serializer,
|
|
||||||
PrettySerializer: d.PrettySerializer,
|
|
||||||
}
|
|
||||||
if d.StreamSerializer != nil {
|
|
||||||
info.StreamSerializer = &runtime.StreamSerializerInfo{
|
|
||||||
Serializer: d.StreamSerializer,
|
|
||||||
EncodesAsText: d.EncodesAsText,
|
|
||||||
Framer: d.Framer,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
accepts = append(accepts, info)
|
|
||||||
if mediaType == runtime.ContentTypeJSON {
|
|
||||||
legacySerializer = d.Serializer
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if legacySerializer == nil {
|
|
||||||
legacySerializer = serializers[0].Serializer
|
|
||||||
}
|
|
||||||
|
|
||||||
return CodecFactory{
|
|
||||||
scheme: scheme,
|
|
||||||
serializers: serializers,
|
|
||||||
universal: recognizer.NewDecoder(decoders...),
|
|
||||||
|
|
||||||
accepts: accepts,
|
|
||||||
|
|
||||||
legacySerializer: legacySerializer,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// SupportedMediaTypes returns the RFC2046 media types that this factory has serializers for.
|
|
||||||
func (f CodecFactory) SupportedMediaTypes() []runtime.SerializerInfo {
|
|
||||||
return f.accepts
|
|
||||||
}
|
|
||||||
|
|
||||||
// LegacyCodec encodes output to a given API versions, and decodes output into the internal form from
|
|
||||||
// any recognized source. The returned codec will always encode output to JSON. If a type is not
|
|
||||||
// found in the list of versions an error will be returned.
|
|
||||||
//
|
|
||||||
// This method is deprecated - clients and servers should negotiate a serializer by mime-type and
|
|
||||||
// invoke CodecForVersions. Callers that need only to read data should use UniversalDecoder().
|
|
||||||
//
|
|
||||||
// TODO: make this call exist only in pkg/api, and initialize it with the set of default versions.
|
|
||||||
// All other callers will be forced to request a Codec directly.
|
|
||||||
func (f CodecFactory) LegacyCodec(version ...schema.GroupVersion) runtime.Codec {
|
|
||||||
return versioning.NewDefaultingCodecForScheme(f.scheme, f.legacySerializer, f.universal, schema.GroupVersions(version), runtime.InternalGroupVersioner)
|
|
||||||
}
|
|
||||||
|
|
||||||
// UniversalDeserializer can convert any stored data recognized by this factory into a Go object that satisfies
|
|
||||||
// runtime.Object. It does not perform conversion. It does not perform defaulting.
|
|
||||||
func (f CodecFactory) UniversalDeserializer() runtime.Decoder {
|
|
||||||
return f.universal
|
|
||||||
}
|
|
||||||
|
|
||||||
// UniversalDecoder returns a runtime.Decoder capable of decoding all known API objects in all known formats. Used
|
|
||||||
// by clients that do not need to encode objects but want to deserialize API objects stored on disk. Only decodes
|
|
||||||
// objects in groups registered with the scheme. The GroupVersions passed may be used to select alternate
|
|
||||||
// versions of objects to return - by default, runtime.APIVersionInternal is used. If any versions are specified,
|
|
||||||
// unrecognized groups will be returned in the version they are encoded as (no conversion). This decoder performs
|
|
||||||
// defaulting.
|
|
||||||
//
|
|
||||||
// TODO: the decoder will eventually be removed in favor of dealing with objects in their versioned form
|
|
||||||
// TODO: only accept a group versioner
|
|
||||||
func (f CodecFactory) UniversalDecoder(versions ...schema.GroupVersion) runtime.Decoder {
|
|
||||||
var versioner runtime.GroupVersioner
|
|
||||||
if len(versions) == 0 {
|
|
||||||
versioner = runtime.InternalGroupVersioner
|
|
||||||
} else {
|
|
||||||
versioner = schema.GroupVersions(versions)
|
|
||||||
}
|
|
||||||
return f.CodecForVersions(nil, f.universal, nil, versioner)
|
|
||||||
}
|
|
||||||
|
|
||||||
// CodecForVersions creates a codec with the provided serializer. If an object is decoded and its group is not in the list,
|
|
||||||
// it will default to runtime.APIVersionInternal. If encode is not specified for an object's group, the object is not
|
|
||||||
// converted. If encode or decode are nil, no conversion is performed.
|
|
||||||
func (f CodecFactory) CodecForVersions(encoder runtime.Encoder, decoder runtime.Decoder, encode runtime.GroupVersioner, decode runtime.GroupVersioner) runtime.Codec {
|
|
||||||
// TODO: these are for backcompat, remove them in the future
|
|
||||||
if encode == nil {
|
|
||||||
encode = runtime.DisabledGroupVersioner
|
|
||||||
}
|
|
||||||
if decode == nil {
|
|
||||||
decode = runtime.InternalGroupVersioner
|
|
||||||
}
|
|
||||||
return versioning.NewDefaultingCodecForScheme(f.scheme, encoder, decoder, encode, decode)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DecoderToVersion returns a decoder that targets the provided group version.
|
|
||||||
func (f CodecFactory) DecoderToVersion(decoder runtime.Decoder, gv runtime.GroupVersioner) runtime.Decoder {
|
|
||||||
return f.CodecForVersions(nil, decoder, nil, gv)
|
|
||||||
}
|
|
||||||
|
|
||||||
// EncoderForVersion returns an encoder that targets the provided group version.
|
|
||||||
func (f CodecFactory) EncoderForVersion(encoder runtime.Encoder, gv runtime.GroupVersioner) runtime.Encoder {
|
|
||||||
return f.CodecForVersions(encoder, nil, gv, nil)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DirectCodecFactory provides methods for retrieving "DirectCodec"s, which do not do conversion.
|
|
||||||
type DirectCodecFactory struct {
|
|
||||||
CodecFactory
|
|
||||||
}
|
|
||||||
|
|
||||||
// EncoderForVersion returns an encoder that does not do conversion.
|
|
||||||
func (f DirectCodecFactory) EncoderForVersion(serializer runtime.Encoder, version runtime.GroupVersioner) runtime.Encoder {
|
|
||||||
return versioning.DirectEncoder{
|
|
||||||
Version: version,
|
|
||||||
Encoder: serializer,
|
|
||||||
ObjectTyper: f.CodecFactory.scheme,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// DecoderToVersion returns an decoder that does not do conversion. gv is ignored.
|
|
||||||
func (f DirectCodecFactory) DecoderToVersion(serializer runtime.Decoder, _ runtime.GroupVersioner) runtime.Decoder {
|
|
||||||
return versioning.DirectDecoder{
|
|
||||||
Decoder: serializer,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,245 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 json
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"io"
|
|
||||||
|
|
||||||
"github.com/ghodss/yaml"
|
|
||||||
"github.com/ugorji/go/codec"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/serializer/recognizer"
|
|
||||||
"k8s.io/apimachinery/pkg/util/framer"
|
|
||||||
utilyaml "k8s.io/apimachinery/pkg/util/yaml"
|
|
||||||
)
|
|
||||||
|
|
||||||
// NewSerializer creates a JSON serializer that handles encoding versioned objects into the proper JSON form. If typer
|
|
||||||
// is not nil, the object has the group, version, and kind fields set.
|
|
||||||
func NewSerializer(meta MetaFactory, creater runtime.ObjectCreater, typer runtime.ObjectTyper, pretty bool) *Serializer {
|
|
||||||
return &Serializer{
|
|
||||||
meta: meta,
|
|
||||||
creater: creater,
|
|
||||||
typer: typer,
|
|
||||||
yaml: false,
|
|
||||||
pretty: pretty,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewYAMLSerializer creates a YAML serializer that handles encoding versioned objects into the proper YAML form. If typer
|
|
||||||
// is not nil, the object has the group, version, and kind fields set. This serializer supports only the subset of YAML that
|
|
||||||
// matches JSON, and will error if constructs are used that do not serialize to JSON.
|
|
||||||
func NewYAMLSerializer(meta MetaFactory, creater runtime.ObjectCreater, typer runtime.ObjectTyper) *Serializer {
|
|
||||||
return &Serializer{
|
|
||||||
meta: meta,
|
|
||||||
creater: creater,
|
|
||||||
typer: typer,
|
|
||||||
yaml: true,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
type Serializer struct {
|
|
||||||
meta MetaFactory
|
|
||||||
creater runtime.ObjectCreater
|
|
||||||
typer runtime.ObjectTyper
|
|
||||||
yaml bool
|
|
||||||
pretty bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// Serializer implements Serializer
|
|
||||||
var _ runtime.Serializer = &Serializer{}
|
|
||||||
var _ recognizer.RecognizingDecoder = &Serializer{}
|
|
||||||
|
|
||||||
// Decode attempts to convert the provided data into YAML or JSON, extract the stored schema kind, apply the provided default gvk, and then
|
|
||||||
// load that data into an object matching the desired schema kind or the provided into. If into is *runtime.Unknown, the raw data will be
|
|
||||||
// extracted and no decoding will be performed. If into is not registered with the typer, then the object will be straight decoded using
|
|
||||||
// normal JSON/YAML unmarshalling. If into is provided and the original data is not fully qualified with kind/version/group, the type of
|
|
||||||
// the into will be used to alter the returned gvk. On success or most errors, the method will return the calculated schema kind.
|
|
||||||
func (s *Serializer) Decode(originalData []byte, gvk *schema.GroupVersionKind, into runtime.Object) (runtime.Object, *schema.GroupVersionKind, error) {
|
|
||||||
if versioned, ok := into.(*runtime.VersionedObjects); ok {
|
|
||||||
into = versioned.Last()
|
|
||||||
obj, actual, err := s.Decode(originalData, gvk, into)
|
|
||||||
if err != nil {
|
|
||||||
return nil, actual, err
|
|
||||||
}
|
|
||||||
versioned.Objects = []runtime.Object{obj}
|
|
||||||
return versioned, actual, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
data := originalData
|
|
||||||
if s.yaml {
|
|
||||||
altered, err := yaml.YAMLToJSON(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, nil, err
|
|
||||||
}
|
|
||||||
data = altered
|
|
||||||
}
|
|
||||||
|
|
||||||
actual, err := s.meta.Interpret(data)
|
|
||||||
if err != nil {
|
|
||||||
return nil, nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
if gvk != nil {
|
|
||||||
// apply kind and version defaulting from provided default
|
|
||||||
if len(actual.Kind) == 0 {
|
|
||||||
actual.Kind = gvk.Kind
|
|
||||||
}
|
|
||||||
if len(actual.Version) == 0 && len(actual.Group) == 0 {
|
|
||||||
actual.Group = gvk.Group
|
|
||||||
actual.Version = gvk.Version
|
|
||||||
}
|
|
||||||
if len(actual.Version) == 0 && actual.Group == gvk.Group {
|
|
||||||
actual.Version = gvk.Version
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if unk, ok := into.(*runtime.Unknown); ok && unk != nil {
|
|
||||||
unk.Raw = originalData
|
|
||||||
unk.ContentType = runtime.ContentTypeJSON
|
|
||||||
unk.GetObjectKind().SetGroupVersionKind(*actual)
|
|
||||||
return unk, actual, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
if into != nil {
|
|
||||||
types, _, err := s.typer.ObjectKinds(into)
|
|
||||||
switch {
|
|
||||||
case runtime.IsNotRegisteredError(err):
|
|
||||||
if err := codec.NewDecoderBytes(data, new(codec.JsonHandle)).Decode(into); err != nil {
|
|
||||||
return nil, actual, err
|
|
||||||
}
|
|
||||||
return into, actual, nil
|
|
||||||
case err != nil:
|
|
||||||
return nil, actual, err
|
|
||||||
default:
|
|
||||||
typed := types[0]
|
|
||||||
if len(actual.Kind) == 0 {
|
|
||||||
actual.Kind = typed.Kind
|
|
||||||
}
|
|
||||||
if len(actual.Version) == 0 && len(actual.Group) == 0 {
|
|
||||||
actual.Group = typed.Group
|
|
||||||
actual.Version = typed.Version
|
|
||||||
}
|
|
||||||
if len(actual.Version) == 0 && actual.Group == typed.Group {
|
|
||||||
actual.Version = typed.Version
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(actual.Kind) == 0 {
|
|
||||||
return nil, actual, runtime.NewMissingKindErr(string(originalData))
|
|
||||||
}
|
|
||||||
if len(actual.Version) == 0 {
|
|
||||||
return nil, actual, runtime.NewMissingVersionErr(string(originalData))
|
|
||||||
}
|
|
||||||
|
|
||||||
// use the target if necessary
|
|
||||||
obj, err := runtime.UseOrCreateObject(s.typer, s.creater, *actual, into)
|
|
||||||
if err != nil {
|
|
||||||
return nil, actual, err
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := codec.NewDecoderBytes(data, new(codec.JsonHandle)).Decode(obj); err != nil {
|
|
||||||
return nil, actual, err
|
|
||||||
}
|
|
||||||
return obj, actual, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Encode serializes the provided object to the given writer.
|
|
||||||
func (s *Serializer) Encode(obj runtime.Object, w io.Writer) error {
|
|
||||||
if s.yaml {
|
|
||||||
json, err := json.Marshal(obj)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
data, err := yaml.JSONToYAML(json)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
_, err = w.Write(data)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
if s.pretty {
|
|
||||||
data, err := json.MarshalIndent(obj, "", " ")
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
_, err = w.Write(data)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
encoder := json.NewEncoder(w)
|
|
||||||
return encoder.Encode(obj)
|
|
||||||
}
|
|
||||||
|
|
||||||
// RecognizesData implements the RecognizingDecoder interface.
|
|
||||||
func (s *Serializer) RecognizesData(peek io.Reader) (ok, unknown bool, err error) {
|
|
||||||
if s.yaml {
|
|
||||||
// we could potentially look for '---'
|
|
||||||
return false, true, nil
|
|
||||||
}
|
|
||||||
_, _, ok = utilyaml.GuessJSONStream(peek, 2048)
|
|
||||||
return ok, false, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Framer is the default JSON framing behavior, with newlines delimiting individual objects.
|
|
||||||
var Framer = jsonFramer{}
|
|
||||||
|
|
||||||
type jsonFramer struct{}
|
|
||||||
|
|
||||||
// NewFrameWriter implements stream framing for this serializer
|
|
||||||
func (jsonFramer) NewFrameWriter(w io.Writer) io.Writer {
|
|
||||||
// we can write JSON objects directly to the writer, because they are self-framing
|
|
||||||
return w
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewFrameReader implements stream framing for this serializer
|
|
||||||
func (jsonFramer) NewFrameReader(r io.ReadCloser) io.ReadCloser {
|
|
||||||
// we need to extract the JSON chunks of data to pass to Decode()
|
|
||||||
return framer.NewJSONFramedReader(r)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Framer is the default JSON framing behavior, with newlines delimiting individual objects.
|
|
||||||
var YAMLFramer = yamlFramer{}
|
|
||||||
|
|
||||||
type yamlFramer struct{}
|
|
||||||
|
|
||||||
// NewFrameWriter implements stream framing for this serializer
|
|
||||||
func (yamlFramer) NewFrameWriter(w io.Writer) io.Writer {
|
|
||||||
return yamlFrameWriter{w}
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewFrameReader implements stream framing for this serializer
|
|
||||||
func (yamlFramer) NewFrameReader(r io.ReadCloser) io.ReadCloser {
|
|
||||||
// extract the YAML document chunks directly
|
|
||||||
return utilyaml.NewDocumentDecoder(r)
|
|
||||||
}
|
|
||||||
|
|
||||||
type yamlFrameWriter struct {
|
|
||||||
w io.Writer
|
|
||||||
}
|
|
||||||
|
|
||||||
// Write separates each document with the YAML document separator (`---` followed by line
|
|
||||||
// break). Writers must write well formed YAML documents (include a final line break).
|
|
||||||
func (w yamlFrameWriter) Write(data []byte) (n int, err error) {
|
|
||||||
if _, err := w.w.Write([]byte("---\n")); err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
return w.w.Write(data)
|
|
||||||
}
|
|
||||||
@@ -1,63 +0,0 @@
|
|||||||
/*
|
|
||||||
Copyright 2014 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 json
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"k8s.io/apimachinery/pkg/runtime/schema"
|
|
||||||
)
|
|
||||||
|
|
||||||
// MetaFactory is used to store and retrieve the version and kind
|
|
||||||
// information for JSON objects in a serializer.
|
|
||||||
type MetaFactory interface {
|
|
||||||
// Interpret should return the version and kind of the wire-format of
|
|
||||||
// the object.
|
|
||||||
Interpret(data []byte) (*schema.GroupVersionKind, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
// DefaultMetaFactory is a default factory for versioning objects in JSON. The object
|
|
||||||
// in memory and in the default JSON serialization will use the "kind" and "apiVersion"
|
|
||||||
// fields.
|
|
||||||
var DefaultMetaFactory = SimpleMetaFactory{}
|
|
||||||
|
|
||||||
// SimpleMetaFactory provides default methods for retrieving the type and version of objects
|
|
||||||
// that are identified with an "apiVersion" and "kind" fields in their JSON
|
|
||||||
// serialization. It may be parameterized with the names of the fields in memory, or an
|
|
||||||
// optional list of base structs to search for those fields in memory.
|
|
||||||
type SimpleMetaFactory struct {
|
|
||||||
}
|
|
||||||
|
|
||||||
// Interpret will return the APIVersion and Kind of the JSON wire-format
|
|
||||||
// encoding of an object, or an error.
|
|
||||||
func (SimpleMetaFactory) Interpret(data []byte) (*schema.GroupVersionKind, error) {
|
|
||||||
findKind := struct {
|
|
||||||
// +optional
|
|
||||||
APIVersion string `json:"apiVersion,omitempty"`
|
|
||||||
// +optional
|
|
||||||
Kind string `json:"kind,omitempty"`
|
|
||||||
}{}
|
|
||||||
if err := json.Unmarshal(data, &findKind); err != nil {
|
|
||||||
return nil, fmt.Errorf("couldn't get version/kind; json parse error: %v", err)
|
|
||||||
}
|
|
||||||
gv, err := schema.ParseGroupVersion(findKind.APIVersion)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return &schema.GroupVersionKind{Group: gv.Group, Version: gv.Version, Kind: findKind.Kind}, nil
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user