unit-threaded 项目教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01172/article/details/142017484

unit-threaded 项目教程

unit-threadedAdvanced unit test framework for D项目地址:https://gitcode.com/gh_mirrors/un/unit-threaded

1. 项目的目录结构及介绍

unit-threaded 是一个用于 D 编程语言的多线程单元测试框架。项目的目录结构如下：

unit-threaded/
├── github/
│   └── workflows/
│       ├── build
│       └── example
├── source/
│   └── unit_threaded/
│       ├── subpackages/
│       └── tests/
├── codecov.yml
├── .gitignore
├── LICENSE
├── README.md
├── TODO.txt
└── dub.json

目录结构介绍

github/workflows/: 包含 GitHub Actions 的工作流配置文件。
source/unit_threaded/: 项目的核心源代码目录，包含子包和测试文件。
codecov.yml: Codecov 配置文件，用于代码覆盖率报告。
.gitignore: Git 忽略文件配置。
LICENSE: 项目的开源许可证文件。
README.md: 项目的介绍和使用说明。
TODO.txt: 项目待办事项列表。
dub.json: 项目的 Dub 配置文件，用于构建和依赖管理。

2. 项目的启动文件介绍

unit-threaded 项目的启动文件通常是 source/unit_threaded/main.d 或 source/unit_threaded/runTestsMain.d。这些文件负责初始化测试环境并运行测试。

启动文件示例

import unit_threaded;

mixin runTestsMain(
    "mypkg.mymod0",
    "mypkg.mymod1"
);

启动文件介绍

import unit_threaded: 导入 unit-threaded 库。
mixin runTestsMain: 使用 mixin 来手动列出包含测试的模块，并运行这些测试。

3. 项目的配置文件介绍

unit-threaded 项目的主要配置文件是 dub.json，它用于定义项目的构建配置、依赖关系和测试配置。

dub.json 配置文件示例

{
  "name": "myproject",
  "targetType": "executable",
  "targetPath": "bin",
  "configurations": [
    {
      "name": "executable"
    },
    {
      "name": "unittest",
      "targetType": "executable",
      "preBuildCommands": [
        "$DUB run --compiler=$$DC unit-threaded -c gen_ut_main -- -f bin/ut.d -d $DUB"
      ],
      "mainSourceFile": "bin/ut.d",
      "excludedSourceFiles": ["src/main.d"],
      "dependencies": {
        "unit-threaded": "*"
      }
    }
  ]
}

配置文件介绍

name: 项目名称。
targetType: 目标类型，通常为 executable。
targetPath: 构建目标的输出路径。
configurations: 定义不同的构建配置。
- name: 配置名称，如 executable 和 unittest。
- preBuildCommands: 在构建前执行的命令，用于生成测试运行文件。
- mainSourceFile: 主源文件路径。
- excludedSourceFiles: 排除的源文件，避免链接错误。
- dependencies: 项目依赖，如 unit-threaded。