Function TestSpec_PublicAPI_Exclude

pkg/sliceutil/spec_test.go:211–237

TestSpec_PublicAPI_Exclude validates the documented behavior of Exclude as described in the sliceutil README.md specification. Specification: "Returns a new slice with all exclude values removed while preserving order" README example: filtered := sliceutil.Exclude([]string{"a", "b", "c"}, "b")

(t *testing.T)

//	filtered := sliceutil.Exclude([]string{"a", "b", "c"}, "b")
//	// filtered = ["a", "c"]
func TestSpec_PublicAPI_Exclude(t *testing.T) {
	t.Run("removes excluded values preserving order", func(t *testing.T) {
		filtered := Exclude([]string{"a", "b", "c"}, "b")
		assert.Equal(t, []string{"a", "c"}, filtered,
			"Exclude should remove matching values and keep original order")
	})

	t.Run("removes multiple excluded values", func(t *testing.T) {
		filtered := Exclude([]string{"a", "b", "c", "d"}, "b", "d")
		assert.Equal(t, []string{"a", "c"}, filtered,
			"Exclude should remove every matching exclude value")
	})

	t.Run("returns base unchanged when no exclude values match", func(t *testing.T) {
		filtered := Exclude([]string{"a", "b", "c"}, "z")
		assert.Equal(t, []string{"a", "b", "c"}, filtered,
			"Exclude with no matching excludes should yield the base elements in order")
	})

	t.Run("does not modify input base slice", func(t *testing.T) {
		original := []string{"a", "b", "c"}
		input := make([]string, len(original))
		copy(input, original)
		_ = Exclude(input, "b")
		assert.Equal(t, original, input, "Exclude must not modify the input base slice")
	})
}