moby: github.com/moby/moby/api/types/filters Index | Examples | Files

package filters

import "github.com/moby/moby/api/types/filters"

Package filters provides tools for encoding a mapping of keys to a set of multiple values.

Index

Examples

Package Files

parse.go

Variables

var ErrBadFormat = errors.New("bad format of filter (expected name=value)")

ErrBadFormat is an error returned when a filter is not in the form key=value

Deprecated: this error will be removed in a future version

func ToJSON Uses

func ToJSON(a Args) (string, error)

ToJSON returns the Args as a JSON encoded string

func ToParam Uses

func ToParam(a Args) (string, error)

ToParam encodes the Args as args JSON encoded string

Deprecated: use ToJSON

func ToParamWithVersion Uses

func ToParamWithVersion(version string, a Args) (string, error)

ToParamWithVersion encodes Args as a JSON string. If version is less than 1.22 then the encoded format will use an older legacy format where the values are a list of strings, instead of a set.

Deprecated: Use ToJSON

type Args Uses

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

Args stores a mapping of keys to a set of multiple values.

func FromJSON Uses

func FromJSON(p string) (Args, error)

FromJSON decodes a JSON encoded string into Args

func FromParam Uses

func FromParam(p string) (Args, error)

FromParam decodes a JSON encoded string into Args

Deprecated: use FromJSON

func NewArgs Uses

func NewArgs(initialArgs ...KeyValuePair) Args

NewArgs returns a new Args populated with the initial args

func ParseFlag Uses

func ParseFlag(arg string, prev Args) (Args, error)

ParseFlag parses a key=value string and adds it to an Args.

Deprecated: Use Args.Add()

func (Args) Add Uses

func (args Args) Add(key, value string)

Add a new value to the set of values

func (Args) Contains Uses

func (args Args) Contains(field string) bool

Contains returns true if the key exists in the mapping

func (Args) Del Uses

func (args Args) Del(key, value string)

Del removes a value from the set

func (Args) ExactMatch Uses

func (args Args) ExactMatch(key, source string) bool

ExactMatch returns true if the source matches exactly one of the values.

func (Args) FuzzyMatch Uses

func (args Args) FuzzyMatch(key, source string) bool

FuzzyMatch returns true if the source matches exactly one value, or the source has one of the values as a prefix.

func (Args) Get Uses

func (args Args) Get(key string) []string

Get returns the list of values associated with the key

func (Args) Include Uses

func (args Args) Include(field string) bool

Include returns true if the key exists in the mapping

Deprecated: use Contains

func (Args) Len Uses

func (args Args) Len() int

Len returns the number of keys in the mapping

func (Args) MarshalJSON Uses

func (args Args) MarshalJSON() ([]byte, error)

MarshalJSON returns a JSON byte representation of the Args

func (Args) Match Uses

func (args Args) Match(field, source string) bool

Match returns true if any of the values at key match the source string

func (Args) MatchKVList Uses

func (args Args) MatchKVList(key string, sources map[string]string) bool

MatchKVList returns true if all the pairs in sources exist as key=value pairs in the mapping at key, or if there are no values at key.

Code:

args := NewArgs(
    Arg("label", "image=foo"),
    Arg("label", "state=running"))

// returns true because there are no values for bogus
args.MatchKVList("bogus", nil)

// returns false because there are no sources
args.MatchKVList("label", nil)

// returns true because all sources are matched
args.MatchKVList("label", map[string]string{
    "image": "foo",
    "state": "running",
})

// returns false because the values do not match
args.MatchKVList("label", map[string]string{
    "image": "other",
})

func (Args) UniqueExactMatch Uses

func (args Args) UniqueExactMatch(key, source string) bool

UniqueExactMatch returns true if there is only one value and the source matches exactly the value.

func (Args) UnmarshalJSON Uses

func (args Args) UnmarshalJSON(raw []byte) error

UnmarshalJSON populates the Args from JSON encode bytes

func (Args) Validate Uses

func (args Args) Validate(accepted map[string]bool) error

Validate compared the set of accepted keys against the keys in the mapping. An error is returned if any mapping keys are not in the accepted set.

func (Args) WalkValues Uses

func (args Args) WalkValues(field string, op func(value string) error) error

WalkValues iterates over the list of values for a key in the mapping and calls op() for each value. If op returns an error the iteration stops and the error is returned.

type KeyValuePair Uses

type KeyValuePair struct {
    Key   string
    Value string
}

KeyValuePair are used to initialize a new Args

func Arg Uses

func Arg(key, value string) KeyValuePair

Arg creates a new KeyValuePair for initializing Args

Package filters imports 5 packages (graph). Updated 2017-09-29. Refresh now. Tools for package owners.