utils

Documentation

Overview

Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at

http://aws.amazon.com/apache2.0/

or in the "license" file accompanying this file. This file 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.

Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at

http://aws.amazon.com/apache2.0/

or in the "license" file accompanying this file. This file 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.

Index

• Variables
• func CompleteJsonUnmarshal(b []byte, iface interface{}) error
• func DefaultIfBlank(str string, default_value string) string
• func ExtractVersion(input string) string
• func GetCPUFlags(cpuInfo *CPUInfo) map[string]bool
• func GetCanonicalPath(path string) string
• func GetENIAttachmentId(eniAttachmentArn string) (string, error)
• func GetTaskID(taskARN string) (string, error)
• func IsAWSErrorCodeEqual(err error, code string) bool
• func JsonKeys(b []byte) ([]string, error)
• func MapToTags(tagsMap map[string]string) []*ecs.Tag
• func NewJitteredTicker(ctx context.Context, start, end time.Duration) <-chan time.Time
• func ParseBool(str string, default_ bool) bool
• func ParseRepositoryTag(repoTag string) (repository string, tag string)
• func RandHex() string
• func SearchStrInDir(dir, filePrefix, content string) error
• func SignHTTPRequest(req *http.Request, region, service string, creds *credentials.Credentials, ...) error
• func SlicesDeepEqual(slice1, slice2 interface{}) bool
• func StrSliceContains(strs []string, s string) bool
• func StrSliceEqual(s1, s2 []string) bool
• func Strptr(s string) *string
• func Uint16SliceToStringSlice(slice []uint16) []*string
• func ZeroOrNil(obj interface{}) bool
• type CPUInfo
  • func ReadCPUInfo(path string) (*CPUInfo, error)
• type ChanSemaphore
  • func (s *ChanSemaphore) Post()
  • func (s *ChanSemaphore) Wait()
• type LicenseProvider
  • func NewLicenseProvider() LicenseProvider
• type Processor
• type Semaphore
  • func NewSemaphore(count int) Semaphore
• type UUIDProvider
  • func NewDynamicUUIDProvider() UUIDProvider
  • func NewStaticUUIDProvider(staticID string) UUIDProvider
• type Version
  • func (lhs Version) Matches(selector string) (bool, error)

Variables

var (
	OpenFile = os.Open
)

Functions

func CompleteJsonUnmarshal

func CompleteJsonUnmarshal(b []byte, iface interface{}) error

CompleteJsonUnmarshal determines if a given struct has members corresponding to every key of a json object (passed as the json string). By default, Go ignores fields in an object which have no corresponding struct member and this can be used to determine if this ignoring has occurred Errors will result in "false" as a return value

func DefaultIfBlank

func DefaultIfBlank(str string, default_value string) string

func ExtractVersion

func ExtractVersion(input string) string

ExtractVersion extracts a matching version from the version number string

func GetCPUFlags

func GetCPUFlags(cpuInfo *CPUInfo) map[string]bool

GetCPUFlags merges all processors' flags and return as a map. Returning map makes it easy to check whether a flag exists or not.

func GetCanonicalPath

func GetCanonicalPath(path string) string

func GetENIAttachmentId

func GetENIAttachmentId(eniAttachmentArn string) (string, error)

GetENIAttachmentId retrieves the attachment ID from eni attachment ARN.

func GetTaskID

func GetTaskID(taskARN string) (string, error)

GetTaskID retrieves the task ID from task ARN.

func IsAWSErrorCodeEqual

func IsAWSErrorCodeEqual(err error, code string) bool

IsAWSErrorCodeEqual returns true if the err implements Error interface of awserr and it has the same error code as the passed in error code.

func JsonKeys

func JsonKeys(b []byte) ([]string, error)

JsonKeys takes an arbitrary byte array representing a json stringified object and returns all the keys of that object.

func MapToTags

func MapToTags(tagsMap map[string]string) []*ecs.Tag

MapToTags converts a map to a slice of tags.

func NewJitteredTicker

func NewJitteredTicker(ctx context.Context, start, end time.Duration) <-chan time.Time

NewJitteredTicker works like a time.Ticker except with randomly distributed ticks between start and end duration.

func ParseBool

func ParseBool(str string, default_ bool) bool

func ParseRepositoryTag

func ParseRepositoryTag(repoTag string) (repository string, tag string)

ParseRepositoryTag mimics the go-dockerclient's ParseReposirotyData. The only difference is that it doesn't ignore the sha when present.

func RandHex

func RandHex() string

func SearchStrInDir

func SearchStrInDir(dir, filePrefix, content string) error

SearchStrInDir searches the files in directory for specific content

func SignHTTPRequest

func SignHTTPRequest(req *http.Request, region, service string, creds *credentials.Credentials, body io.ReadSeeker) error

SignHTTPRequest signs an http.Request struct with authv4 using the given region, service, and credentials.

func SlicesDeepEqual

func SlicesDeepEqual(slice1, slice2 interface{}) bool

SlicesDeepEqual checks if slice1 and slice2 are equal, disregarding order.

func StrSliceContains

func StrSliceContains(strs []string, s string) bool

func StrSliceEqual

func StrSliceEqual(s1, s2 []string) bool

func Strptr

func Strptr(s string) *string

func Uint16SliceToStringSlice

func Uint16SliceToStringSlice(slice []uint16) []*string

Uint16SliceToStringSlice converts a slice of type uint16 to a slice of type *string. It uses strconv.Itoa on each element

func ZeroOrNil

func ZeroOrNil(obj interface{}) bool

Types

type CPUInfo

type CPUInfo struct {
	Processors []Processor `json:"processors"`
}

func ReadCPUInfo

func ReadCPUInfo(path string) (*CPUInfo, error)

type ChanSemaphore

type ChanSemaphore struct {
	Count int // Public for introspection; should not be written to
	// contains filtered or unexported fields
}

Implements semaphore

func (*ChanSemaphore) Post

func (s *ChanSemaphore) Post()

func (*ChanSemaphore) Wait

func (s *ChanSemaphore) Wait()

type LicenseProvider

type LicenseProvider interface {
	GetText() (string, error)
}

func NewLicenseProvider

func NewLicenseProvider() LicenseProvider

type Processor

type Processor struct {
	Flags []string `json:"flags"`
}

type Semaphore

type Semaphore interface {
	Post()
	Wait()
}

func NewSemaphore

func NewSemaphore(count int) Semaphore

type UUIDProvider

type UUIDProvider interface {
	New() string
}

UUIDProvider wraps 'uuid' methods for testing

func NewDynamicUUIDProvider

func NewDynamicUUIDProvider() UUIDProvider

NewDynamicUUIDProvider returns a new dynamicUUIDProvider

func NewStaticUUIDProvider

func NewStaticUUIDProvider(staticID string) UUIDProvider

NewStaticUUIDProvider returns a new staticUUIDProvider

type Version

type Version string

func (Version) Matches

func (lhs Version) Matches(selector string) (bool, error)

Matches returns whether or not a version matches a given selector. The selector can be any of the following:

* x.y.z -- Matches a version exactly the same as the selector version * >=x.y.z -- Matches a version greater than or equal to the selector version * >x.y.z -- Matches a version greater than the selector version * <=x.y.z -- Matches a version less than or equal to the selector version * <x.y.z -- Matches a version less than the selector version * x.y.z,a.b.c -- Matches if the version matches either of the two selector versions