docs: add knownvalue func check documentation

Author: bschaatsbergen

website/docs/plugin/testing/acceptance-tests/known-value-checks/bool.mdx

@@ -1,14 +1,15 @@
 ---
 page_title: 'Plugin Development - Acceptance Testing: Known Values'
 description: >-
-    Bool Value Checks for use with Plan Checks.
+    Bool Value Checks for use with Plan and State Checks.
 ---
 
 # Bool Known Value Checks
 
 The known value checks that are available for bool values are:
 
 * [Bool](/terraform/plugin/testing/acceptance-tests/known-value-checks/bool#bool-check)
+* [BoolFunc](/terraform/plugin/testing/acceptance-tests/known-value-checks/bool#boolfunc-check)
 
 ## `Bool` Check
 
@@ -40,3 +41,37 @@ func TestExpectKnownValue_CheckPlan_Bool(t *testing.T) {
 	})
 }
 ```
+
+## `BoolFunc` Check
+
+The [BoolFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#BoolFunc) check allows defining a custom function to validate whether the bool value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [BoolFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#BoolFunc) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_BoolFunc(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing a boolean attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.BoolFunc(func(v bool) error {
+							if !v {
+								return fmt.Errorf("expected true, got %t", v)
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```

website/docs/plugin/testing/acceptance-tests/known-value-checks/float32.mdx

@@ -1,14 +1,15 @@
 ---
 page_title: 'Plugin Development - Acceptance Testing: Known Values'
 description: >-
-    Float32 Value Checks for use with Plan Checks.
+    Float32 Value Checks for use with Plan and State Checks.
 ---
 
 # Float32 Known Value Checks
 
 The known value checks that are available for float32 values are:
 
 * [Float32Exact](/terraform/plugin/testing/acceptance-tests/known-value-checks/float32#float32exact-check)
+* [Float32Func](/terraform/plugin/testing/acceptance-tests/known-value-checks/float32#float32func-check)
 
 ## `Float32Exact` Check
 
@@ -40,3 +41,37 @@ func TestExpectKnownValue_CheckPlan_Float32(t *testing.T) {
 	})
 }
 ```
+
+## `Float32Func` Check
+
+The [Float32Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Float32Func) check allows defining a custom function to validate whether the float32 value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [Float32Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Float32Func) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_Float32Func(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing a float32 attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.Float32Func(func(v float32) error {
+							if v > 1.0 && v < 5.0 {
+								return fmt.Errorf("value must be between 1.0 and 5.0")
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```

website/docs/plugin/testing/acceptance-tests/known-value-checks/float64.mdx

@@ -9,6 +9,7 @@ description: >-
 The known value checks that are available for float64 values are:
 
 * [Float64Exact](/terraform/plugin/testing/acceptance-tests/known-value-checks/float64#float64exact-check)
+* [Float64Func](/terraform/plugin/testing/acceptance-tests/known-value-checks/float64#float64func-check)
 
 ## `Float64Exact` Check
 
@@ -40,3 +41,37 @@ func TestExpectKnownValue_CheckPlan_Float64(t *testing.T) {
 	})
 }
 ```
+
+## `Float64Func` Check
+
+The [Float64Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Float64Func) check allows defining a custom function to validate whether the float64 value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [Float64Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Float64Func) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_Float64Func(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing a float64 attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.Float64Func(func(v float64) error {
+							if v > 1.0 && v < 5.0 {
+								return fmt.Errorf("value must be between 1.0 and 5.0")
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```

website/docs/plugin/testing/acceptance-tests/known-value-checks/int32.mdx

@@ -1,14 +1,15 @@
 ---
 page_title: 'Plugin Development - Acceptance Testing: Known Values'
 description: >-
-    Int32 Value Checks for use with Plan Checks.
+    Int32 Value Checks for use with Plan and State Checks.
 ---
 
 # Int32 Known Value Checks
 
 The known value checks that are available for int32 values are:
 
 * [Int32Exact](/terraform/plugin/testing/acceptance-tests/known-value-checks/int32#int32exact-check)
+* [Int32Func](/terraform/plugin/testing/acceptance-tests/known-value-checks/int32#int32func-check)
 
 ## `Int32Exact` Check
 
@@ -40,3 +41,37 @@ func TestExpectKnownValue_CheckPlan_Int32(t *testing.T) {
 	})
 }
 ```
+
+## `Int32Func` Check
+
+The [Int32Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Int32Func) check allows defining a custom function to validate whether the int32 value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [Int32Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Int32Func) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_Int32Func(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing an int32 attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.Int32Func(func(v int32) error {
+							if v < 1 && v > 12 {
+								return fmt.Errorf("range cannot be less than 1 or greater than 12")
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```

website/docs/plugin/testing/acceptance-tests/known-value-checks/int64.mdx

@@ -1,14 +1,15 @@
 ---
 page_title: 'Plugin Development - Acceptance Testing: Known Values'
 description: >-
-    Int64 Value Checks for use with Plan Checks.
+    Int64 Value Checks for use with Plan and State Checks.
 ---
 
 # Int64 Known Value Checks
 
 The known value checks that are available for int64 values are:
 
 * [Int64Exact](/terraform/plugin/testing/acceptance-tests/known-value-checks/int64#int64exact-check)
+* [Int64Func](/terraform/plugin/testing/acceptance-tests/known-value-checks/int64#int64func-check)
 
 ## `Int64Exact` Check
 
@@ -40,3 +41,37 @@ func TestExpectKnownValue_CheckPlan_Int64(t *testing.T) {
 	})
 }
 ```
+
+## `Int64Func` Check
+
+The [Int64Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Int64Func) check allows defining a custom function to validate whether the int64 value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [Int64Func](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#Int64Func) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_Int64Func(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing an int64 attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.Int64Func(func(v int64) error {
+							if v > 1 && v < 12 {
+								return fmt.Errorf("value must be between 1 and 12")
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```

website/docs/plugin/testing/acceptance-tests/known-value-checks/number.mdx

@@ -46,3 +46,36 @@ func TestExpectKnownValue_CheckPlan_Number(t *testing.T) {
 	})
 }
 ```
+
+## `NumberFunc` Check
+
+The [NumberFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#NumberFunc) check allows defining a custom function to validate whether the number value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [NumberFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#NumberFunc) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_NumberFunc(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing a number attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.NumberFunc(func(v *big.Float) error {
+                            if err := testConfigurableAttribute(v); err != nil {
+								return fmt.Errorf("attribute validation failed: %w", err)
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}

website/docs/plugin/testing/acceptance-tests/known-value-checks/string.mdx

@@ -10,6 +10,7 @@ The known value checks that are available for string values are:
 
 * [StringExact](/terraform/plugin/testing/acceptance-tests/known-value-checks/string#stringexact-check)
 * [StringRegexp](/terraform/plugin/testing/acceptance-tests/known-value-checks/string#stringregexp-check)
+* [StringFunc](/terraform/plugin/testing/acceptance-tests/known-value-checks/string#stringfunc-check)
 
 ## `StringExact` Check
 
@@ -70,3 +71,37 @@ func TestExpectKnownValue_CheckPlan_StringRegexp(t *testing.T) {
 	})
 }
 ```
+
+## `StringFunc` Check
+
+The [StringFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#StringFunc) check allows defining a custom function to validate whether the string value of a resource attribute or output satisfies specific conditions.
+
+Example usage of [StringFunc](https://pkg.go.dev/github.com/hashicorp/terraform-plugin-testing/knownvalue#StringFunc) in an [ExpectKnownValue](/terraform/plugin/testing/acceptance-tests/state-checks/resource) state check.
+
+```go
+func TestExpectKnownValue_CheckState_StringFunc(t *testing.T) {
+	t.Parallel()
+
+	resource.Test(t, resource.TestCase{
+		// Provider definition omitted.
+		Steps: []resource.TestStep{
+			{
+				// Example resource containing a string attribute named "configurable_attribute"
+				Config: `resource "test_resource" "one" {}`,
+				ConfigStateChecks: []statecheck.StateCheck{
+					statecheck.ExpectKnownValue(
+						"test_resource.one",
+						tfjsonpath.New("configurable_attribute"),
+						knownvalue.StringFunc(func(v string) error {
+                            if !strings.HasPrefix(v, "str") {
+								return fmt.Errorf("value must start with 'str'")
+							}
+                            return nil
+						}),
+					),
+				},
+			},
+		},
+	})
+}
+```