commit fbdfb13edf20fbfe6bb99bd487e1f9c646acacf9
Author: Chen Asraf <casraf@pm.me>
Date:   Mon Sep 9 23:37:20 2024 +0300

    feat: initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0e0706c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# chenasraf/goutils
+
+Just some generic & common golang utils I commonly use in Go projects.
+
+```sh
+go get github.com/chenasraf/goutils
+```
diff --git a/go.mod b/go.mod
new file mode 100644
index 0000000..242fe22
--- /dev/null
+++ b/go.mod
@@ -0,0 +1,5 @@
+module github.com/chenasraf/utils
+
+go 1.23.0
+
+require github.com/rivo/uniseg v0.4.7
diff --git a/go.sum b/go.sum
new file mode 100644
index 0000000..9008848
--- /dev/null
+++ b/go.sum
@@ -0,0 +1,2 @@
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
diff --git a/utils.go b/utils.go
new file mode 100644
index 0000000..511927d
--- /dev/null
+++ b/utils.go
@@ -0,0 +1,90 @@
+package utils
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"sort"
+
+	"github.com/rivo/uniseg"
+)
+
+func MapSlice[T, V any](ts []T, fn func(T) V) []V {
+	result := make([]V, len(ts))
+	for i, t := range ts {
+		result[i] = fn(t)
+	}
+	return result
+}
+
+func HandleErr(err error) {
+	if err != nil {
+		fmt.Println(err)
+		os.Exit(1)
+	}
+}
+
+func FileExists(path string) bool {
+	_, err := os.Stat(path)
+	exists := !os.IsNotExist(err)
+	return exists
+}
+
+func GlobExists(path string) bool {
+	res, err := filepath.Glob(path)
+	HandleErr(err)
+	return res != nil
+}
+
+func ReadFile(path string) string {
+	res, err := os.ReadFile(path)
+	HandleErr(err)
+	return string(res)
+}
+
+func MapKeys[K comparable, V any](mapObj map[K]V) []K {
+	keys := make([]K, len(mapObj))
+	i := 0
+	for k := range mapObj {
+		keys[i] = k
+		i++
+	}
+	return keys
+}
+
+func SliceContains[T comparable](list []T, item T) bool {
+	for _, v := range list {
+		if v == item {
+			return true
+		}
+	}
+	return false
+}
+
+func RunCmd(cmd string, args ...string) (string, error) {
+	res, err := exec.Command(cmd, args...).Output()
+	return string(res), err
+}
+
+func Ternary[T any](cond bool, whenTrue T, whenFalse T) T {
+	if cond {
+		return whenTrue
+	}
+	return whenFalse
+}
+
+func Insert[T any](a []T, i int, item T) []T {
+	return append(a[:i], append([]T{item}, a[i:]...)...)
+}
+
+func SortAlphanumeric(slice []string) []string {
+	sort.SliceStable(slice, func(i, j int) bool {
+		return slice[i] < slice[j]
+	})
+	return slice
+}
+
+func StrLen(str string) int {
+	return uniseg.GraphemeClusterCount(str)
+}