add cut function support

Author: mschuchard

CHANGELOG.md

@@ -1,5 +1,5 @@
 ### 1.6.0 (Next)
-- Add `product` function.
+- Add `product` and `cut` functions.
 - Optimize data source `id` where possible (may cause superficial plan changes to existing states).
 
 ### 1.5.1

examples/data-sources/stdlib_cut/data-source.tf

@@ -0,0 +1,13 @@
+# Return the separated strings:
+data "stdlib_cut" "foobarbaz" {
+  param     = "foobarbaz"
+  separator = "bar"
+}
+# before => "foo", after => "baz", found = true
+
+# Return the separated strings with absent separator:
+data "stdlib_cut" "pizza" {
+  param     = "foobarbaz"
+  separator = "pizza"
+}
+# before => "foobarbaz", after => "", found = false

stdlib/provider.go

@@ -79,6 +79,7 @@ func (*stdlibProvider) DataSources(_ context.Context) []func() datasource.DataSo
 		slicefunc.NewProductDataSource,
 		slicefunc.NewReplaceDataSource,
 		slicefunc.NewSortListDataSource,
+		stringfunc.NewCutDataSource,
 		stringfunc.NewLastCharDataSource,
 	}
 }

stdlib/string/cut_data_source_test.go

@@ -0,0 +1,54 @@
+package stringfunc_test
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-testing/helper/resource"
+
+	provider "github.com/mschuchard/terraform-provider-stdlib/stdlib"
+)
+
+func TestAccCut(test *testing.T) {
+	// invoke test
+	resource.ParallelTest(test, resource.TestCase{
+		ProtoV6ProviderFactories: provider.TestAccProtoV6ProviderFactories,
+		Steps: []resource.TestStep{
+			// test basic string cut
+			{
+				Config: `data "stdlib_cut" "test" {
+				  param     = "foobarbaz"
+				  separator = "bar"
+				}`,
+				Check: resource.ComposeAggregateTestCheckFunc(
+					// verify input param is stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "param", "foobarbaz"),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "separator", "bar"),
+					// verify before, after, and found are stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "before", "foo"),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "after", "baz"),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "found", "true"),
+					// verify id stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "id", "foobarbaz"),
+				),
+			},
+			// test basic string cut absent separator
+			{
+				Config: `data "stdlib_cut" "test" {
+					param     = "foobarbaz"
+					separator = "pizza"
+				  }`,
+				Check: resource.ComposeAggregateTestCheckFunc(
+					// verify input param is stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "param", "foobarbaz"),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "separator", "pizza"),
+					// verify before, after, and found are stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "before", "foobarbaz"),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "after", ""),
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "found", "false"),
+					// verify id stored correctly
+					resource.TestCheckResourceAttr("data.stdlib_cut.test", "id", "foobarbaz"),
+				),
+			},
+		},
+	})
+}