Project Icon

go-txdb

Go语言单事务SQL驱动 提升测试效率与隔离性

go-txdb是一个为Go语言开发的单事务数据库SQL驱动。它在建立连接时自动启动事务,确保所有操作在同一事务内执行,特别适合快速且隔离的功能测试。该驱动兼容任何sql.Driver连接,可以注册为不同的驱动名称。通过事务回滚机制,go-txdb能够在测试结束后保持数据库状态不变,显著提升测试效率。这个工具主要用于需要数据库访问的测试场景,目前支持MySQL和PostgreSQL数据库。

构建状态 GoDoc

GO语言的单事务SQL驱动

txdb包是一个基于单事务的数据库SQL驱动。当连接打开时,它会启动一个事务,并且在这个sql.DB上执行的所有操作都将在该事务内进行。如果执行并发操作,会获取锁并始终释放连接,语句和行不会持有连接。

为什么它有用?一个非常基本的用例是,如果你想进行功能测试,你可以准备一个测试数据库,在每个测试中你不需要重新加载数据库。所有测试都在事务内隔离,因此执行速度快。而且你不需要在代码中改变你的sql.DB引用,txdb就像一个标准的sql.Driver

这个驱动支持打开任何sql.Driver连接。你可以为不同的SQL驱动注册txdb,并将其置于不同的驱动名下。在底层,每当打开txdb驱动时,它会尝试打开一个真实的连接并启动事务。当调用关闭时,它会回滚事务,使你准备好的测试数据库保持在与之前相同的状态。

假设你有一个名为txdb_test的mysql数据库,其中有一个users表,表中有一个username列。

package main

import (
    "database/sql"
    "log"

    "github.com/DATA-DOG/go-txdb"
    _ "github.com/go-sql-driver/mysql"
)

func init() {
    // 我们注册一个名为"txdb"的SQL驱动
    txdb.Register("txdb", "mysql", "root@/txdb_test")
}

func main() {
    // dsn作为连接池的唯一标识符
    db, err := sql.Open("txdb", "identifier")
    if err != nil {
        log.Fatal(err)
    }
    defer db.Close()

    if _, err := db.Exec(`INSERT INTO users(username) VALUES("gopher")`); err != nil {
        log.Fatal(err)
    }
}

如果你喜欢,你也可以使用sql.OpenDB(Go 1.10中新增)而不是注册txdb驱动实例:

package main

import (
    "database/sql"
    "log"

    "github.com/DATA-DOG/go-txdb"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    db := sql.OpenDB(txdb.New("mysql", "root@/txdb_test"))
    defer db.Close()

    if _, err := db.Exec(`INSERT INTO users(username) VALUES("gopher")`); err != nil {
        log.Fatal(err)
    }
}

每次运行这个应用程序时,它都会保持与之前相同的状态。

测试

使用主要面向测试目的。测试需要数据库访问,支持使用postgresmysql数据库。最简单的方法是使用testcontainers,通过将各自的数据库DSN值设置为AUTO来启用。例如:

MYSQL_DSN=AUTO PSQL_DSN=AUTO go test ./...

如果你想使用正在运行的本地数据库实例,你也可以直接提供DSN,它将被使用:

MYSQL_DSN=root:pass@/ PSQL_DSN=postgres://postgres:pass@localhost/ go test ./...

要仅针对MySQL或PostgreSQL运行测试,你可以只提供各自的DSN值;任何未设置的DSN都会在测试中被跳过。

文档

有关一般API详细信息,请参阅godoc。 有关支持的go版本,请参阅**.travis.yml**。

贡献

欢迎提交拉取请求。请注意,如果你希望对公共(导出的方法或类型)进行扩展,请先开一个issue讨论这些更改是否可以被接受。所有向后不兼容的更改都将被谨慎对待。

公共API已锁定,因为它是一个sql.Driver,不会改变。

许可证

txdb采用三条款BSD许可证授权

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号