sqlite

github.com/taouniverse/tao-sqlite

Tao Universe 组件单元（Unit），基于泛型工厂模式封装 SQLite 嵌入式数据库。

安装

go get github.com/taouniverse/tao-sqlite

使用

导入

import _ "github.com/taouniverse/tao-sqlite"

配置

# 单实例配置
sqlite:
  db: app.db

# 多实例配置
sqlite:
  default_instance: app
  app:
    db: data/app.db
  log:
    db: data/log.db

配置字段说明

工厂模式 API

使用示例

获取连接并执行操作

package main

import (
    "log"
    
    "github.com/taouniverse/tao-sqlite"
)

func main() {
    // 获取默认实例
    db, err := sqlite.DB()
    if err != nil {
        log.Fatal(err)
    }
    
    // 获取底层 sql.DB 进行 Ping 测试
    sqlDB, err := db.DB()
    if err != nil {
        log.Fatal(err)
    }
    
    err = sqlDB.Ping()
    if err != nil {
        log.Fatal(err)
    }
    log.Println("SQLite 连接成功")
}

GORM 操作

db, _ := sqlite.DB()

// 自动迁移
db.AutoMigrate(&User{})

// 创建记录
db.Create(&User{Name: "tao", Age: 18})

// 查询记录
var user User
db.First(&user, "name = ?", "tao")

// 更新记录
db.Model(&user).Update("age", 20)

// 删除记录
db.Delete(&user)

多实例使用

// 获取应用数据库
appDB, _ := sqlite.GetDB("app")

// 获取日志数据库
logDB, _ := sqlite.GetDB("log")

// 应用数据操作
appDB.Create(&User{Name: "tao"})

// 日志记录操作
logDB.Create(&Log{Message: "user created"})

单元测试

快速测试

# 仅运行配置相关测试
go test -v -run "TestConfig" ./...

完整集成测试

# 运行单实例测试
make test

# 运行多实例测试
make test-multi

# 运行所有测试
make test-all

# 生成覆盖率报告
make coverage

# 清理测试生成的数据库文件
make clean

手动测试

# 运行单实例测试
go test -v ./...

# 运行多实例测试
TAO_TEST_MULTI_INSTANCE=true go test -v ./...

特性

• 纯 Go 实现：使用 modernc.org/sqlite，无 CGO 依赖，跨平台编译友好
• 嵌入式：适合轻量级应用、开发环境和测试场景
• 多实例：支持同时操作多个 SQLite 数据库文件

开发指南