goutils

Goutils

中文

A Go utility library for database abstraction, HTTP routing, and logging.

• Requires Go 1.24+ (uses generics)

go get github.com/Carry-Rao/goutils

Modules

Contributing: CONTRIBUTION.md · 中文

Database in one snippet

import (
	"github.com/Carry-Rao/goutils/database"
	"github.com/Carry-Rao/goutils/database/factory"
)

type User struct {
	ID   int    `db:"id,primary"`
	Name string `db:"name"`
}

db, err := factory.New[User]("memory", nil)
if err != nil {
	panic(err)
}

if err := db.Create("users", map[string]database.Config{
	"id":   {PrimaryKey: true},
	"name": {Type: "TEXT"},
}); err != nil {
	panic(err)
}

tbl, _ := db.GetTable("users", User{})
_ = tbl.Ins(User{ID: 1, Name: "Alice"}, 0)

users, _ := tbl.Get(User{ID: 1}, nil, 0) // []User, not []any

Backends register themselves on import, mirroring database/sql. Import database/factory to get every built-in backend, or import a single backend package and call its NewDatabase directly to skip the indirection.

Breaking changes from the generics refactor

• api.Database / api.Table moved to the root database package and are now generic: database.Database[T], database.Table[T]
• Construction moved to factory.New[T](name, cfg) / factory.Open[T](dbType, cfg)
• Table.Get returns []T instead of []any
• The database/api and database/api/typed packages are gone
• router.BadRequest became router.MethodNotAllowed; status code 400 → 405
• Router :any was removed; :string is the only catch-all and does not span /

Status

Integration tests cover the in-process backends (memory, bloom, mixture). The MySQL, PostgreSQL, SQLite, and Redis backends compile and are exercised by the type checker but are not covered by automated tests, as they require external services. Not recommended for production use without your own testing.