首页
/ Stacks-core项目中的测试标签化改进方案

Stacks-core项目中的测试标签化改进方案

2025-06-26 09:44:59作者:董灵辛Dennis

背景介绍

在软件开发过程中,测试是保证代码质量的重要环节。stacks-core作为一个区块链项目,其测试体系面临着一些挑战:测试筛选不够灵活、难以按功能模块执行测试、开发环境友好度不足等问题。这些问题直接影响了开发效率和CI/CD流程的优化。

现有测试体系的问题分析

当前stacks-core项目的测试筛选主要依赖两种方式:

  1. 使用#[ignore]属性标记需要跳过的测试用例(如耗时测试或复杂集成测试)
  2. 通过测试函数的完整路径名来精确选择或排除特定测试

这种机制存在明显不足:

  • 无法基于功能上下文(如加密相关、签名相关、共识相关等)进行灵活筛选
  • 难以定义合理的执行策略(独立运行、并行执行等)
  • 对本地开发环境不够友好
  • 与CI/CD流程的集成不够顺畅

解决方案设计

核心思路

引入一个名为testag的专用crate,通过过程宏实现测试标签化功能。该方案具有以下特点:

  1. 标签配置集中管理:通过Cargo.toml文件统一管理允许使用的标签集合
  2. 简单易用的标注语法:使用属性宏轻松为测试函数添加标签
  3. 运行时筛选:避免因改变筛选条件而触发重新编译
  4. 兼容性设计:支持标准测试框架和主流测试宏(如tokio、should_panic等)

技术实现细节

方案采用了一种巧妙的名称转换机制:将测试函数转换为模块结构,并将标签信息编码到模块路径中。例如:

原始测试函数:

fn test_hello()

添加"fast"标签后转换为:

test_hello::t::fast::t

这种转换保持了原始测试路径的同时,嵌入了标签信息,形成了独特的模式:t::tag1::tag2::tag3::t。这种结构既便于模式匹配,又能有效避免命名冲突。

实际应用示例

标签配置

在Cargo.toml中定义允许使用的标签集合:

[package.metadata.testag] 
allowed = ["fast", "slow", "crypto"]

测试标注

在测试代码中使用标签:

#[tag(fast)]
#[test]
fn test_quick() { assert!(true); }

#[tag(fast, crypto)]
#[test]
fn test_quick_btc() { assert!(true); }

测试执行

  1. 使用cargo test筛选快速测试:
cargo test :fast:
  1. 使用cargo nextest进行复杂筛选:
cargo nextest --filter-expr 'test(:slow:) and test(:crypto:)'
  1. 通过配置文件定义测试profile:
[profile.btcslow]
default-filter = "test(:slow:) and test(:crypto:)"

方案优势与价值

  1. 提升开发体验:开发者可以轻松筛选相关测试,提高本地开发效率
  2. 优化CI/CD流程:支持复杂的测试筛选逻辑,便于构建不同的测试场景
  3. 维护成本低:标签集中管理,避免标签滥用和拼写错误
  4. 兼容性强:与现有测试工具链无缝集成,无需改变开发习惯

总结

stacks-core项目通过引入测试标签化系统,有效解决了测试筛选不灵活的问题。该方案不仅提升了开发效率,还为持续集成流程提供了更多可能性。这种基于宏和模块路径转换的技术实现,既保持了Rust语言的特性,又提供了简洁易用的接口,是测试体系优化的一个典范。

对于其他Rust项目而言,这种测试标签化思路同样具有参考价值,特别是在需要复杂测试筛选和分类的场景下。项目团队已经在一个名为pinny-rs的仓库中实现了这一方案,为后续在stacks-core中的集成奠定了基础。

登录后查看全文

项目优选

收起
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
15
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
568
412
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
125
208
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
75
145
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
431
38
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
98
253
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
693
91
folibfolib
FOLib 是一个为Ai研发而生的、全语言制品库和供应链服务平台
Java
42
2
CS-BooksCS-Books
🔥🔥超过1000本的计算机经典书籍、个人笔记资料以及本人在各平台发表文章中所涉及的资源等。书籍资源包括C/C++、Java、Python、Go语言、数据结构与算法、操作系统、后端架构、计算机系统知识、数据库、计算机网络、设计模式、前端、汇编以及校招社招各种面经~
100
13
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
298
1.03 K