Documentation ¶
Overview ¶
Package util provides utility functions for the cmd packages.
Index ¶
- Constants
- Variables
- func AllLocalIP4() ([]net.IP, error)
- func CertPoolFromFile(filename string) (*x509.CertPool, error)
- func CertificatesFromFile(file string) ([]*x509.Certificate, error)
- func DefaultLocalIP4() (net.IP, error)
- func Env(key string, defaultValue string) string
- func EnvInt(key string, defaultValue int32, minValue int32) int32
- func GetCertificateFunc(certs map[string]*tls.Certificate) func(*tls.ClientHelloInfo) (*tls.Certificate, error)
- func GetDisplayFilename(filename string) string
- func GetDistributionName(binaryName string) string
- func GetEnv(key string) (string, bool)
- func GetPlatformName(binaryName string) string
- func GetProductName(binaryName string) string
- func HostnameMatchSpecCandidates(hostname string) []string
- func HostnameMatches(hostname string, matchSpec string) bool
- func InitLogrus()
- func ListenAndServeTLS(srv *http.Server, network string, certFile, keyFile string) error
- func MakeAbs(path, base string) (string, error)
- func MakeRelative(path, base string) (string, error)
- func NewGLogWriterV(level int) io.Writer
- func PrivateKeysFromPEM(pemCerts []byte) ([]byte, error)
- func RelativizePathWithNoBacksteps(refs []*string, base string) error
- func ReplaceCommandName(from, to string, c *cobra.Command) *cobra.Command
- func ResolvePaths(refs []*string, base string) error
- func ResolveResource(defaultResource schema.GroupResource, resourceString string, ...) (schema.GroupResource, string, error)
- func SiblingCommand(cmd *cobra.Command, name string) []string
- func TryListen(network, hostPort string) (bool, error)
- func WaitForSuccessfulDial(https bool, network, address string, timeout, interval time.Duration, ...) error
- func WarnAboutCommaSeparation(errout io.Writer, values []string, flag string)
Constants ¶
const (
ProductOpenShift = `OpenShift`
)
Variables ¶
var ErrorNoDefaultIP = errors.New("no suitable IP address")
ErrorNoDefaultIP is returned when no suitable non-loopback address can be found.
Functions ¶
func AllLocalIP4 ¶
AllLocalIP4 returns all the IPv4 addresses that this host can be reached on.
func CertificatesFromFile ¶
func CertificatesFromFile(file string) ([]*x509.Certificate, error)
func DefaultLocalIP4 ¶
DefaultLocalIP4 returns an IPv4 address that this host can be reached on. Will return NoDefaultIP if no suitable address can be found.
func GetCertificateFunc ¶ added in v1.0.7
func GetCertificateFunc(certs map[string]*tls.Certificate) func(*tls.ClientHelloInfo) (*tls.Certificate, error)
GetCertificateFunc returns a function that can be used in tls.Config#GetCertificate Returns nil if len(certs) == 0
func GetDisplayFilename ¶ added in v1.0.6
GetDisplayFilename returns the absolute path of the filename as long as there was no error, otherwise it returns the filename as-is
func GetDistributionName ¶ added in v1.0.7
GetDistributionName returns an appropriate Kubernetes distribution name. Distribution name can be used in relation to some feature set in command's usage string (e.g. <distribution name> allows you to build, run, etc.).
func GetPlatformName ¶ added in v1.0.7
GetPlatformName returns an appropriate platform name for given binary name. Platform name can be used as a headline in command's usage.
func GetProductName ¶ added in v1.0.7
GetProductName chooses appropriate product for a binary name.
func HostnameMatchSpecCandidates ¶ added in v1.0.7
HostnameMatchSpecCandidates returns a list of match specs that would match the provided hostname Returns nil if len(hostname) == 0
func HostnameMatches ¶ added in v1.0.7
HostnameMatches returns true if the given hostname is matched by the given matchSpec
func InitLogrus ¶
func InitLogrus()
InitLogrus sets the logrus trace level based on the glog trace level.
func ListenAndServeTLS ¶ added in v1.0.5
ListenAndServeTLS starts a server that listens on the provided TCP mode (as supported by net.Listen).
func MakeRelative ¶
func NewGLogWriterV ¶ added in v1.3.0
NewGLogWriterV returns a new Writer that delegates to `glog.Info` at the desired level of verbosity
func PrivateKeysFromPEM ¶ added in v1.1.4
PrivateKeysFromPEM extracts all blocks recognized as private keys into an output PEM encoded byte array, or returns an error. If there are no private keys it will return an empty byte buffer.
func RelativizePathWithNoBacksteps ¶
RelativizePathWithNoBacksteps updates the given refs to be relative paths, relative to the given base directory as long as they do not require backsteps. Any path requiring a backstep is left as-is as long it is absolute. Any non-absolute path that can't be relativized produces an error
func ReplaceCommandName ¶ added in v1.3.0
ReplaceCommandName recursively processes the examples in a given command to change a hardcoded command name (like 'kubectl' to the appropriate target name). It returns c.
func ResolvePaths ¶
ResolvePaths updates the given refs to be absolute paths, relative to the given base directory
func ResolveResource ¶ added in v1.0.8
func ResolveResource(defaultResource schema.GroupResource, resourceString string, mapper meta.RESTMapper) (schema.GroupResource, string, error)
ResolveResource returns the resource type and name of the resourceString. If the resource string has no specified type, defaultResource will be returned.
func SiblingCommand ¶ added in v1.3.0
SiblingCommand returns a sibling command to the given command
func TryListen ¶
TryListen tries to open a connection on the given port and returns true if it succeeded.
Types ¶
This section is empty.