Unlock Go’s gobox Framework: Exception Handling, Utilities & Practical Examples

Introduction Today we introduce our self‑developed Go lightweight framework gobox . Each module is a "box" and the collection of boxes forms gobox, which can be imported via Go's package management.

Exception Handling

Go lacks a built‑in exception mechanism; we can simulate it with panic / recover, but it is not recommended. The gobox exception package wraps an error code (errno) and message (msg).

package main

import (
    "github.com/goinbox/exception"
    "fmt"
)

func main() {
    e := exception.New(101, "test exception")
    fmt.Println(e.Errno(), e.Msg())
    fmt.Println(e.Error())
}

Utility Functions (gomisc)

The gomisc package provides various helpers.

Slice Deduplication

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
)

func main() {
    is := []int{1,2,2,3,3,3,4,4,4,4}
    fmt.Println("origin slice is:", is)
    is = gomisc.IntSliceUnique(is)
    fmt.Println("after call slice is:", is)

    ss := []string{"a","ab","ab","abc","abc","abc","abcd","abcd","abcd","abcd","abcd"}
    fmt.Println("origin slice is:", ss)
    ss = gomisc.StringSliceUnique(ss)
    fmt.Println("after call slice is:", ss)
}

File/Directory Existence

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
)

func main() {
    f := "/etc/passwd"
    if gomisc.FileExist(f) {
        fmt.Println(f, "is exist")
    } else {
        fmt.Println(f, "is not exist")
    }

    d := "/home/ligang/devspace"
    if gomisc.DirExist(d) {
        fmt.Println(d, "is exist")
    } else {
        fmt.Println(d, "is not exist")
    }
}

Recursive File Listing

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
    "time"
)

func main() {
    fileList, err := gomisc.ListFilesInDir("/home/ligang/tmp")
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, path := range fileList {
        fmt.Println(path)
    }
}

JSON Save & Parse

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
)

func main() {
    filePath := "/tmp/test_save_parse_json_file.json"
    v1 := map[string]string{"k1": "a", "k2": "b", "k3": "c"}
    if err := gomisc.SaveJsonFile(filePath, v1); err != nil {
        fmt.Println("save json file failed:", err.Error())
    } else {
        fmt.Println("save json file success")
    }

    var v2 map[string]string
    if err := gomisc.ParseJsonFile(filePath, &v2); err != nil {
        fmt.Println("parse json file failed:", err.Error())
    } else {
        fmt.Println("parse json file success")
        for k, v := range v2 {
            if v != v1[k] {
                fmt.Println("save parse json file error, k:", k, "not equal")
            } else {
                fmt.Println("save parse json file k:", k, "equal")
            }
        }
    }
}

Substring Extraction

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
)

func main() {
    s := "abcdefg"
    if sub, err := gomisc.SubString(s, 3, 20); err == nil {
        fmt.Println("substr", sub)
    }
    if sub, err := gomisc.SubString(s, 10, 3); err == nil {
        fmt.Println("substr", sub)
    }
    if ss, err := gomisc.SubString(s, 3, 4); err == nil {
        fmt.Println(s, "substr", ss)
    }
}

Time Formatting Constants

const (
    TIME_FMT_STR_YEAR   = "2006"
    TIME_FMT_STR_MONTH  = "01"
    TIME_FMT_STR_DAY    = "02"
    TIME_FMT_STR_HOUR   = "15"
    TIME_FMT_STR_MINUTE = "04"
    TIME_FMT_STR_SECOND = "05"
)

Using gomisc.TimeGeneralLayout() returns the layout 2006-01-02 15:04:05, which can format the current time.

layout := gomisc.TimeGeneralLayout()
fmt.Println("fmt layout is", layout)
fmt.Println("not time is", time.Now().Format(layout))

Random Number Generation by Time

package main

import (
    "github.com/goinbox/gomisc"
    "fmt"
    "time"
)

func main() {
    tm := time.Now()
    fmt.Println(gomisc.RandByTime(&tm), gomisc.RandByTime(&tm), gomisc.RandByTime(nil))
}

Note: identical timestamps produce identical random results.