Thing is a Go ORM focused on fast CRUD, ID-based loading, list queries, and built-in cache invalidation. It uses generics for type-safe model access and supports SQLite, MySQL, and PostgreSQL.
For detailed usage, model tags, relationships, cache-friendly query patterns, and raw SQL guidance, see the usage guides:
go get github.com/burugo/thingpackage main
import (
"log""github.com/burugo/thing""github.com/burugo/thing/drivers/db/sqlite"
)
typeUserstruct {
thing.BaseModelNamestring`db:"name,index"`Emailstring`db:"email,unique"`
}
funcmain() {
db, err:=sqlite.NewSQLiteAdapter("app.db")
iferr!=nil {
log.Fatal(err)
}
iferr:=thing.Configure(db, nil); err!=nil { // nil uses the built-in memory cachelog.Fatal(err)
}
iferr:=thing.AutoMigrate(&User{}); err!=nil {
log.Fatal(err)
}
users, err:=thing.Use[*User]()
iferr!=nil {
log.Fatal(err)
}
alice:=&User{Name: "Alice", Email: "alice@example.com"}
iferr:=users.Save(alice); err!=nil {
log.Fatal(err)
}
cachedUser, err:=users.ByID(alice.ID)
iferr!=nil {
log.Fatal(err)
}
_=cachedUseractiveUsers, err:=users.
Where("name LIKE ?", "A%").
Order("id DESC").
Fetch(0, 20)
iferr!=nil {
log.Fatal(err)
}
_=activeUsers
}Save,SaveMany,ByID,ByIDs,Delete,DeleteMany, andSoftDelete- Paginated list queries through
Query(...).Fetch(offset, limit) - Count caching through
Query(...).Count() - Model cache reuse when list results are hydrated
- Cache invalidation for common
WHEREandORDER BYpatterns - Relationship preloading without hand-written joins
Thing intentionally keeps the ORM surface small. For reporting queries, database-specific SQL, or one-off joins, use the raw DBAdapter / *sql.DB accessors and treat those reads as outside the ORM cache path.
Prefer this shape:
ids:= []int64{1, 2, 3}
usersByID, err:=users.ByIDs(ids)or:
page, err:=users.Where("id IN (?)", ids).Fetch(0, len(ids))Avoid replacing repeated application reads with SELECT * ... JOIN ... when the same data can be loaded as an ID list and hydrated through ByID / ByIDs. That is the path where Thing can reuse model cache and maintain query cache invalidation.
More examples are in Cache Utilization / 提高缓存利用率.
Run the test suite:
go test ./...MIT