hashicorp
diff --git a/‎.changes/unreleased/FEATURES-20240717-155731.yaml‎
Lines changed: 6 additions & 0 deletions b/‎.changes/unreleased/FEATURES-20240717-155731.yaml‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎.changes/unreleased/FEATURES-20240717-160116.yaml‎
Lines changed: 6 additions & 0 deletions b/‎.changes/unreleased/FEATURES-20240717-160116.yaml‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎.changes/unreleased/FEATURES-20240717-160331.yaml‎
Lines changed: 7 additions & 0 deletions b/‎.changes/unreleased/FEATURES-20240717-160331.yaml‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎.changes/unreleased/FEATURES-20240717-164418.yaml‎
Lines changed: 7 additions & 0 deletions b/‎.changes/unreleased/FEATURES-20240717-164418.yaml‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎.changes/unreleased/NOTES-20240717-155810.yaml‎
Lines changed: 6 additions & 0 deletions b/‎.changes/unreleased/NOTES-20240717-155810.yaml‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎.changes/unreleased/NOTES-20240717-164911.yaml‎
Lines changed: 7 additions & 0 deletions b/‎.changes/unreleased/NOTES-20240717-164911.yaml‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎compare/doc.go‎
Lines changed: 5 additions & 0 deletions b/‎compare/doc.go‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎compare/value_comparer.go‎
Lines changed: 13 additions & 0 deletions b/‎compare/value_comparer.go‎
Lines changed: 13 additions & 0 deletions
diff --git a/‎compare/values_differ.go‎
Lines changed: 31 additions & 0 deletions b/‎compare/values_differ.go‎
Lines changed: 31 additions & 0 deletions
diff --git a/‎compare/values_differ_test.go‎
Lines changed: 62 additions & 0 deletions b/‎compare/values_differ_test.go‎
Lines changed: 62 additions & 0 deletions
@@ -0,0 +1,6 @@
+kind: FEATURES
+body: 'compare: Introduced new `compare` package, which contains interfaces and implementations
+  for value comparisons in state checks.'
+time: 2024-07-17T15:57:31.637692-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,6 @@
+kind: FEATURES
+body: 'statecheck: Added `CompareValue` state check, which compares sequential values of the
+  specified attribute at the given managed resource, or data source, using the supplied value comparer.'
+time: 2024-07-17T16:01:16.194665-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,7 @@
+kind: FEATURES
+body: 'statecheck: Added `CompareValueCollection` state check, which compares each item in
+  the specified collection (e.g., list, set) attribute, with the second specified
+  attribute at the given managed resources, or data sources, using the supplied value comparer.'
+time: 2024-07-17T16:03:31.77827-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,7 @@
+kind: FEATURES
+body: 'statecheck: Added `CompareValuePairs` state check, which compares the
+  specified attributes at the given managed resources, or data sources, using
+  the supplied value comparer.'
+time: 2024-07-17T16:44:18.612874-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,6 @@
+kind: NOTES
+body: 'compare: The `compare` package is considered experimental and may be altered
+  or removed in a subsequent release'
+time: 2024-07-17T15:58:10.435384-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,7 @@
+kind: NOTES
+body: 'statecheck: `CompareValue`, `CompareValueCollection`, and `CompareValuePairs`
+  state checks are considered experimental and may be altered or removed in a subsequent
+  release.'
+time: 2024-07-17T16:49:11.296585-04:00
+custom:
+  Issue: "330"
@@ -0,0 +1,5 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+
+// Package compare contains the value comparer interface, and types implementing the value comparer interface.
+package compare
@@ -0,0 +1,13 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+
+package compare
+
+// ValueComparer defines an interface that is implemented to run comparison logic on multiple values. Individual
+// implementations determine how the comparison is performed (e.g., values differ, values equal).
+type ValueComparer interface {
+	// CompareValues should assert the given known values against any expectations.
+	// Values are always ordered in the order they were added. Use the error
+	// return to signal unexpected values or implementation errors.
+	CompareValues(values ...any) error
+}
@@ -0,0 +1,31 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+
+package compare
+
+import (
+	"fmt"
+	"reflect"
+)
+
+var _ ValueComparer = valuesDiffer{}
+
+type valuesDiffer struct{}
+
+// CompareValues determines whether each value in the sequence of the supplied values
+// differs from the preceding value.
+func (v valuesDiffer) CompareValues(values ...any) error {
+	for i := 1; i < len(values); i++ {
+		if reflect.DeepEqual(values[i-1], values[i]) {
+			return fmt.Errorf("expected values to differ, but they are the same: %v == %v", values[i-1], values[i])
+		}
+	}
+
+	return nil
+}
+
+// ValuesDiffer returns a ValueComparer for asserting that each value in the sequence of
+// the values supplied to the CompareValues method differs from the preceding value.
+func ValuesDiffer() valuesDiffer {
+	return valuesDiffer{}
+}
@@ -0,0 +1,62 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+
+package compare_test
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/google/go-cmp/cmp"
+
+	"github.com/hashicorp/terraform-plugin-testing/compare"
+)
+
+func TestValuesDiffer_CompareValues(t *testing.T) {
+	t.Parallel()
+
+	testCases := map[string]struct {
+		in            []any
+		expectedError error
+	}{
+		"nil": {},
+		"single-value": {
+			in: []any{"str"},
+		},
+		"non-matching-sequential-values": {
+			in: []any{"str", "other_str", "str"},
+		},
+		"matching-values-string": {
+			in:            []any{"str", "other_str", "other_str"},
+			expectedError: fmt.Errorf("expected values to differ, but they are the same: other_str == other_str"),
+		},
+		"matching-values-slice": {
+			in: []any{
+				[]any{"other_str"},
+				[]any{"other_str"},
+			},
+			expectedError: fmt.Errorf("expected values to differ, but they are the same: [other_str] == [other_str]"),
+		},
+		"matching-values-map": {
+			in: []any{
+				map[string]any{"a": "other_str"},
+				map[string]any{"a": "other_str"},
+			},
+			expectedError: fmt.Errorf("expected values to differ, but they are the same: map[a:other_str] == map[a:other_str]"),
+		},
+	}
+
+	for name, testCase := range testCases {
+		name, testCase := name, testCase
+
+		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
+			err := compare.ValuesDiffer().CompareValues(testCase.in...)
+
+			if diff := cmp.Diff(err, testCase.expectedError, equateErrorMessage); diff != "" {
+				t.Errorf("unexpected difference: %s", diff)
+			}
+		})
+	}
+}