Added Prepend Function

.circleci/config.yml

@@ -20,7 +20,7 @@ parameters:
 executors:
   def:
     docker:
-      - image: cimg/go:1.20
+      - image: cimg/go:1.21
 
 jobs:
   co:

go.mod

@@ -1,9 +1,22 @@
 module github.com/kohirens/stdlib
 
-go 1.16
+go 1.21
 
 require (
 	github.com/aws/aws-lambda-go v1.45.0
 	github.com/google/uuid v1.6.0
 	go.mongodb.org/mongo-driver v1.13.1
 )
+
+require (
+	github.com/golang/snappy v0.0.1 // indirect
+	github.com/klauspost/compress v1.13.6 // indirect
+	github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe // indirect
+	github.com/xdg-go/pbkdf2 v1.0.0 // indirect
+	github.com/xdg-go/scram v1.1.2 // indirect
+	github.com/xdg-go/stringprep v1.0.4 // indirect
+	github.com/youmark/pkcs8 v0.0.0-20181117223130-1be2e3e5546d // indirect
+	golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d // indirect
+	golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4 // indirect
+	golang.org/x/text v0.7.0 // indirect
+)

go.sum

@@ -1,6 +1,5 @@
 github.com/aws/aws-lambda-go v1.45.0 h1:3xS35Dlc8ffmcwfcKTyqJGiMuL0UDvkQaVUrI5yHycI=
 github.com/aws/aws-lambda-go v1.45.0/go.mod h1:dpMpZgvWx5vuQJfBt0zqBha60q7Dd7RfgJv23DymV8A=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/golang/snappy v0.0.1 h1:Qgr9rKW7uDUkrbSmQeiDsGa8SjGyCOGtuasMWwvp2P4=
@@ -15,7 +14,6 @@ github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe h1:iruDEfMl2E6f
 github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe/go.mod h1:wL8QJuTMNUDYhXwkmfOly8iTdp5TEcJFWZD2D7SIkUc=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/testify v1.7.2 h1:4jaiDzPyXQvSd7D0EjG45355tLlV3VOECpq10pLC+8s=
 github.com/stretchr/testify v1.7.2/go.mod h1:R6va5+xMeoiuVRoj+gSkQ7d3FALtqAAGI1FQKckRals=
 github.com/xdg-go/pbkdf2 v1.0.0 h1:Su7DPu48wXMwC3bs7MCNG+z4FhcyEuz5dlvchbq0B0c=
@@ -62,6 +60,5 @@ golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc
 golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

mongodb/mongodb.go

@@ -1,3 +1,6 @@
+// Package mongodb
+// Deprecated see github.com/kohirens/mongodb standalone library. This will be
+// removed in the next major release.
 package mongodb
 
 import (

slice/slice.go

@@ -1,12 +1,23 @@
 package slice
 
 // PrependInt Put an element at the beginning of a slice.
+// Deprecated see Prepend
 func PrependInt(item int, ary []int) (s []int) {
 	return append([]int{item}, ary...)
 }
 
 // PrependByte Put an element at the beginning of a byte slice.
+// Deprecated see Prepend
 func PrependByte(item byte, ary []byte) (s []byte) {
 	str := string(item)
 	return append([]byte(str), ary...)
 }
+
+// Prepend Put an element at the beginning of a byte slice.
+//
+//	NOTE: This is inefficient as it touches every element of the array, and is
+//	only meant for small arrays.
+func Prepend[V comparable](ary []V, item V) []V {
+	newAry := []V{item}
+	return append(newAry, ary...)
+}

slice/slice_test.go

@@ -2,6 +2,7 @@ package slice
 
 import (
 	"bytes"
+	"reflect"
 	"testing"
 )
 
@@ -49,3 +50,22 @@ func TestPrependInt(tr *testing.T) {
 		})
 	}
 }
+
+func TestPrepend(t *testing.T) {
+	type testCase[V comparable] struct {
+		name string
+		ary  []V
+		item V
+		want []V
+	}
+	tests := []testCase[int]{
+		{"int", []int{2, 3}, 1, []int{1, 2, 3}},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			if got := Prepend(tt.ary, tt.item); !reflect.DeepEqual(got, tt.want) {
+				t.Errorf("Prepend() = %v, want %v", got, tt.want)
+			}
+		})
+	}
+}

web/web.go

@@ -1,3 +1,6 @@
+// Package web
+// Deprecated see github.com/kohirens/web standalone library. This will be
+// removed in the next major release.
 package web
 
 type StringMap map[string]string