dockertest: github.com/ory/dockertest/docker/opts Index | Files

package opts

import "github.com/ory/dockertest/docker/opts"

Index

Package Files

env.go hosts.go hosts_unix.go ip.go opts.go opts_unix.go quotedstring.go runtime.go ulimit.go

Constants

const DefaultHTTPHost = "localhost"

DefaultHTTPHost Default HTTP Host used if only port is provided to -H flag e.g. dockerd -H tcp://:8080

Variables

var (
    // DefaultHTTPPort Default HTTP Port used if only the protocol is provided to -H flag e.g. dockerd -H tcp://
    // These are the IANA registered port numbers for use with Docker
    // see http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=docker
    DefaultHTTPPort = 2375 // Default HTTP Port
    // DefaultTLSHTTPPort Default HTTP Port used when TLS enabled
    DefaultTLSHTTPPort = 2376 // Default TLS encrypted HTTP Port
    // DefaultUnixSocket Path for the unix socket.
    // Docker daemon by default always listens on the default unix socket
    DefaultUnixSocket = "/var/run/docker.sock"
    // DefaultTCPHost constant defines the default host string used by docker on Windows
    DefaultTCPHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultHTTPPort)
    // DefaultTLSHost constant defines the default host string used by docker for TLS sockets
    DefaultTLSHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultTLSHTTPPort)
    // DefaultNamedPipe defines the default named pipe used by docker on Windows
    DefaultNamedPipe = `//./pipe/docker_engine`
)
var DefaultHost = fmt.Sprintf("unix://%s", DefaultUnixSocket)

DefaultHost constant defines the default host string used by docker on other hosts than Windows

func MountParser Uses

func MountParser(mount string) (source, destination string, err error)

MountParser parses mount path.

func ParseHost Uses

func ParseHost(defaultToTLS bool, val string) (string, error)

ParseHost and set defaults for a Daemon host string

func ParseLink(val string) (string, string, error)

ParseLink parses and validates the specified string as a link format (name:alias)

func ParseTCPAddr Uses

func ParseTCPAddr(tryAddr string, defaultAddr string) (string, error)

ParseTCPAddr parses and validates that the specified address is a valid TCP address. It returns a formatted TCP address, either using the address parsed from tryAddr, or the contents of defaultAddr if tryAddr is a blank string. tryAddr is expected to have already been Trim()'d defaultAddr must be in the full `tcp://host:port` form

func ValidateDNSSearch Uses

func ValidateDNSSearch(val string) (string, error)

ValidateDNSSearch validates domain for resolvconf search configuration. A zero length domain is represented by a dot (.).

func ValidateEnv Uses

func ValidateEnv(val string) (string, error)

ValidateEnv validates an environment variable and returns it. If no value is specified, it returns the current value using os.Getenv.

As on ParseEnvFile and related to #16585, environment variable names are not validate what so ever, it's up to application inside docker to validate them or not.

The only validation here is to check if name is empty, per #25099

func ValidateExtraHost Uses

func ValidateExtraHost(val string) (string, error)

ValidateExtraHost validates that the specified string is a valid extrahost and returns it. ExtraHost is in the form of name:ip where the ip has to be a valid ip (IPv4 or IPv6).

func ValidateHost Uses

func ValidateHost(val string) (string, error)

ValidateHost validates that the specified string is a valid host and returns it.

func ValidateIPAddress Uses

func ValidateIPAddress(val string) (string, error)

ValidateIPAddress validates an Ip address.

func ValidateLabel Uses

func ValidateLabel(val string) (string, error)

ValidateLabel validates that the specified string is a valid label, and returns it. Labels are in the form on key=value.

func ValidateSingleGenericResource Uses

func ValidateSingleGenericResource(val string) (string, error)

ValidateSingleGenericResource validates that a single entry in the generic resource list is valid. i.e 'GPU=UID1' is valid however 'GPU:UID1' or 'UID1' isn't

type IPOpt Uses

type IPOpt struct {
    *net.IP
}

IPOpt holds an IP. It is used to store values from CLI flags.

func NewIPOpt Uses

func NewIPOpt(ref *net.IP, defaultVal string) *IPOpt

NewIPOpt creates a new IPOpt from a reference net.IP and a string representation of an IP. If the string is not a valid IP it will fallback to the specified reference.

func (*IPOpt) Set Uses

func (o *IPOpt) Set(val string) error

Set sets an IPv4 or IPv6 address from a given string. If the given string is not parsable as an IP address it returns an error.

func (*IPOpt) String Uses

func (o *IPOpt) String() string

String returns the IP address stored in the IPOpt. If stored IP is a nil pointer, it returns an empty string.

func (*IPOpt) Type Uses

func (o *IPOpt) Type() string

Type returns the type of the option

type ListOpts Uses

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

ListOpts holds a list of values and a validation function.

func NewListOpts Uses

func NewListOpts(validator ValidatorFctType) ListOpts

NewListOpts creates a new ListOpts with the specified validator.

func NewListOptsRef Uses

func NewListOptsRef(values *[]string, validator ValidatorFctType) *ListOpts

NewListOptsRef creates a new ListOpts with the specified values and validator.

func (*ListOpts) Delete Uses

func (opts *ListOpts) Delete(key string)

Delete removes the specified element from the slice.

func (*ListOpts) Get Uses

func (opts *ListOpts) Get(key string) bool

Get checks the existence of the specified key.

func (*ListOpts) GetAll Uses

func (opts *ListOpts) GetAll() []string

GetAll returns the values of slice.

func (*ListOpts) GetAllOrEmpty Uses

func (opts *ListOpts) GetAllOrEmpty() []string

GetAllOrEmpty returns the values of the slice or an empty slice when there are no values.

func (*ListOpts) GetMap Uses

func (opts *ListOpts) GetMap() map[string]struct{}

GetMap returns the content of values in a map in order to avoid duplicates.

func (*ListOpts) Len Uses

func (opts *ListOpts) Len() int

Len returns the amount of element in the slice.

func (*ListOpts) Set Uses

func (opts *ListOpts) Set(value string) error

Set validates if needed the input value and adds it to the internal slice.

func (*ListOpts) String Uses

func (opts *ListOpts) String() string

func (*ListOpts) Type Uses

func (opts *ListOpts) Type() string

Type returns a string name for this Option type

func (*ListOpts) WithValidator Uses

func (opts *ListOpts) WithValidator(validator ValidatorFctType) *ListOpts

WithValidator returns the ListOpts with validator set.

type MapOpts Uses

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

MapOpts holds a map of values and a validation function.

func NewMapOpts Uses

func NewMapOpts(values map[string]string, validator ValidatorFctType) *MapOpts

NewMapOpts creates a new MapOpts with the specified map of values and a validator.

func (*MapOpts) GetAll Uses

func (opts *MapOpts) GetAll() map[string]string

GetAll returns the values of MapOpts as a map.

func (*MapOpts) Set Uses

func (opts *MapOpts) Set(value string) error

Set validates if needed the input value and add it to the internal map, by splitting on '='.

func (*MapOpts) String Uses

func (opts *MapOpts) String() string

func (*MapOpts) Type Uses

func (opts *MapOpts) Type() string

Type returns a string name for this Option type

type MemBytes Uses

type MemBytes int64

MemBytes is a type for human readable memory bytes (like 128M, 2g, etc)

func (*MemBytes) Set Uses

func (m *MemBytes) Set(value string) error

Set sets the value of the MemBytes by passing a string

func (*MemBytes) String Uses

func (m *MemBytes) String() string

String returns the string format of the human readable memory bytes

func (*MemBytes) Type Uses

func (m *MemBytes) Type() string

Type returns the type

func (*MemBytes) UnmarshalJSON Uses

func (m *MemBytes) UnmarshalJSON(s []byte) error

UnmarshalJSON is the customized unmarshaler for MemBytes

func (*MemBytes) Value Uses

func (m *MemBytes) Value() int64

Value returns the value in int64

type NamedListOpts Uses

type NamedListOpts struct {
    ListOpts
    // contains filtered or unexported fields
}

NamedListOpts is a ListOpts with a configuration name. This struct is useful to keep reference to the assigned field name in the internal configuration struct.

func NewNamedListOptsRef Uses

func NewNamedListOptsRef(name string, values *[]string, validator ValidatorFctType) *NamedListOpts

NewNamedListOptsRef creates a reference to a new NamedListOpts struct.

func (*NamedListOpts) Name Uses

func (o *NamedListOpts) Name() string

Name returns the name of the NamedListOpts in the configuration.

type NamedMapOpts Uses

type NamedMapOpts struct {
    MapOpts
    // contains filtered or unexported fields
}

NamedMapOpts is a MapOpts struct with a configuration name. This struct is useful to keep reference to the assigned field name in the internal configuration struct.

func NewNamedMapOpts Uses

func NewNamedMapOpts(name string, values map[string]string, validator ValidatorFctType) *NamedMapOpts

NewNamedMapOpts creates a reference to a new NamedMapOpts struct.

func (*NamedMapOpts) Name Uses

func (o *NamedMapOpts) Name() string

Name returns the name of the NamedMapOpts in the configuration.

type NamedOption Uses

type NamedOption interface {
    Name() string
}

NamedOption is an interface that list and map options with names implement.

type NamedUlimitOpt Uses

type NamedUlimitOpt struct {
    UlimitOpt
    // contains filtered or unexported fields
}

NamedUlimitOpt defines a named map of Ulimits

func NewNamedUlimitOpt Uses

func NewNamedUlimitOpt(name string, ref *map[string]*units.Ulimit) *NamedUlimitOpt

NewNamedUlimitOpt creates a new NamedUlimitOpt

func (*NamedUlimitOpt) Name Uses

func (o *NamedUlimitOpt) Name() string

Name returns the option name

type QuotedString Uses

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

QuotedString is a string that may have extra quotes around the value. The quotes are stripped from the value.

func NewQuotedString Uses

func NewQuotedString(value *string) *QuotedString

NewQuotedString returns a new quoted string option

func (*QuotedString) Set Uses

func (s *QuotedString) Set(val string) error

Set sets a new value

func (*QuotedString) String Uses

func (s *QuotedString) String() string

func (*QuotedString) Type Uses

func (s *QuotedString) Type() string

Type returns the type of the value

type RuntimeOpt Uses

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

RuntimeOpt defines a map of Runtimes

func NewNamedRuntimeOpt Uses

func NewNamedRuntimeOpt(name string, ref *map[string]types.Runtime, stockRuntime string) *RuntimeOpt

NewNamedRuntimeOpt creates a new RuntimeOpt

func (*RuntimeOpt) GetMap Uses

func (o *RuntimeOpt) GetMap() map[string]types.Runtime

GetMap returns a map of Runtimes (name: path)

func (*RuntimeOpt) Name Uses

func (o *RuntimeOpt) Name() string

Name returns the name of the NamedListOpts in the configuration.

func (*RuntimeOpt) Set Uses

func (o *RuntimeOpt) Set(val string) error

Set validates and updates the list of Runtimes

func (*RuntimeOpt) String Uses

func (o *RuntimeOpt) String() string

String returns Runtime values as a string.

func (*RuntimeOpt) Type Uses

func (o *RuntimeOpt) Type() string

Type returns the type of the option

type UlimitOpt Uses

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

UlimitOpt defines a map of Ulimits

func NewUlimitOpt Uses

func NewUlimitOpt(ref *map[string]*units.Ulimit) *UlimitOpt

NewUlimitOpt creates a new UlimitOpt

func (*UlimitOpt) GetList Uses

func (o *UlimitOpt) GetList() []*units.Ulimit

GetList returns a slice of pointers to Ulimits.

func (*UlimitOpt) Set Uses

func (o *UlimitOpt) Set(val string) error

Set validates a Ulimit and sets its name as a key in UlimitOpt

func (*UlimitOpt) String Uses

func (o *UlimitOpt) String() string

String returns Ulimit values as a string.

func (*UlimitOpt) Type Uses

func (o *UlimitOpt) Type() string

Type returns the option type

type ValidatorFctListType Uses

type ValidatorFctListType func(val string) ([]string, error)

ValidatorFctListType defines a validator function that returns a validated list of string and/or an error

type ValidatorFctType Uses

type ValidatorFctType func(val string) (string, error)

ValidatorFctType defines a validator function that returns a validated string and/or an error.

Package opts imports 12 packages (graph) and is imported by 1 packages. Updated 2019-11-12. Refresh now. Tools for package owners.