collections

func GetSliceIndexValueE(source string, separator string, index int) (string, error)

GetSliceIndexValueE will take a source string and returns the value at the given index when split by the separator char.

Deprecated: scheduled for removal in Terratest v2. Use strings.Split at the call site, e.g.:

parts := strings.Split(source, separator)
val := parts[index]

Note: bounds-check index first; this helper returned the not-found error for an out-of-range or negative index rather than panicking.

func GetSliceLastValueE(source string, separator string) (string, error)

GetSliceLastValueE will take a source string and returns the last value when split by the separator char.

Deprecated: scheduled for removal in Terratest v2. Use strings.Split at the call site, e.g.:

parts := strings.Split(source, separator)
last := parts[len(parts)-1]

Note: strings.Split returns the whole string when the separator is absent, so add a strings.Contains check first if you need the not-found error this helper returned.

func ListContains(haystack []string, needle string) bool

ListContains returns true if the given list of strings (haystack) contains the given string (needle).

Deprecated: scheduled for removal in Terratest v2. Replace at the call site with slices.Contains(haystack, needle) (Go 1.21+).

func ListIntersection[T comparable](list1 []T, list2 []T) []T

ListIntersection returns all the items in both list1 and list2. Note that this will dedup the items so that the output is more predictable. Otherwise, the end list depends on which list was used as the base.

Deprecated: scheduled for removal in Terratest v2. The collections package is being dropped, so there is no drop-in public replacement; build it inline with the slices package (Go 1.21+) at the call site, e.g.:

out := []T{}
for _, x := range list1 {
	if slices.Contains(list2, x) && !slices.Contains(out, x) {
		out = append(out, x)
	}
}

func ListSubtract[T comparable](list1 []T, list2 []T) []T

ListSubtract removes all the items in list2 from list1.

Deprecated: scheduled for removal in Terratest v2. The collections package is being dropped, so there is no drop-in public replacement; build it inline with the slices package (Go 1.21+) at the call site, e.g.:

out := []T{}
for _, x := range list1 {
	if !slices.Contains(list2, x) {
		out = append(out, x)
	}
}