Initial QSfera import

Server/vendor/github.com/gookit/goutil/maputil/README.md

@@ -0,0 +1,72 @@
+# Map Utils
+
+`maputil` provide map data util functions. eg: convert, sub-value get, simple merge
+
+- use `map[string]any` as Data
+- deep get value by key path
+- deep set value by key path
+
+## Install
+
+```bash
+go get github.com/gookit/goutil/maputil
+```
+
+## Go docs
+
+- [Go docs](https://pkg.go.dev/github.com/gookit/goutil/maputil)
+
+## Usage
+
+### Deep get value
+
+```go
+mp := map[string]any {
+	"top1": "val1",
+	"arr1": []string{"ab", "cd"}
+	"map1": map[string]any{
+	    "sub1": "val2",	
+    },
+}
+
+fmt.Println(maputil.DeepGet(mp, "map1.sub1")) // Output: VAL3
+
+// get value from slice.
+fmt.Println(maputil.DeepGet(mp, "arr1.1")) // Output: cd
+fmt.Println(maputil.DeepGet(mp, "arr1[1]")) // Output: cd
+```
+
+### Deep set value
+
+```go
+mp := map[string]any {
+	"top1": "val1",
+	"arr1": []string{"ab"}
+	"map1": map[string]any{
+	    "sub1": "val2",	
+    },
+}
+
+err := maputil.SetByPath(&mp, "map1.newKey", "VAL3")
+
+fmt.Println(maputil.DeepGet(mp, "map1.newKey")) // Output: VAL3
+```
+
+## Code Check & Testing
+
+```bash
+gofmt -w -l ./
+golint ./...
+```
+
+**Testing**:
+
+```shell
+go test -v ./maputil/...
+```
+
+**Test limit by regexp**:
+
+```shell
+go test -v -run ^TestSetByKeys ./maputil/...
+```