Ceedling
适用于 Ceedling C 单元测试框架的 Sublime Text 插件
详情
安装
- 总数 417
- Win 212
- Mac 127
- Linux 78
8 月 6 日 | 8 月 5 日 | 8 月 4 日 | 8 月 3 日 | 8 月 2 日 | 8 月 1 日 | 7 月 31 日 | 7 月 30 日 | 7 月 29 日 | 7 月 28 日 | 7 月 27 日 | 7 月 26 日 | 7 月 25 日 | 7 月 24 日 | 7 月 23 日 | 7 月 22 日 | 7 月 21 日 | 7 月 20 日 | 7 月 19 日 | 7 月 18 日 | 7 月 17 日 | 7 月 16 日 | 7 月 15 日 | 7 月 14 日 | 7 月 13 日 | 7 月 12 日 | 7 月 11 日 | 7 月 10 日 | 7 月 9 日 | 7 月 8 日 | 7 月 7 日 | 7 月 6 日 | 7 月 5 日 | 7 月 4 日 | 7 月 3 日 | 7 月 2 日 | 7 月 1 日 | 6 月 30 日 | 6 月 29 日 | 6 月 28 日 | 6 月 27 日 | 6 月 26 日 | 6 月 25 日 | 6 月 24 日 | 6 月 23 日 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Mac | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
README
适用于 Sublime Text 3+ 的 Ceedling
Ceedling 是一组用于测试和构建 C 应用程序的工具和库。此包为使用 Ceedling 在 Sublime Text 3+ 中开发 C 应用程序提供了支持。
重要提示
适用于 Sublime Text 3+ 的 Ceedling 与原始的 Sublime Text 2 版本存在重大更改,不再支持使用 rake
启动命令。
这反映了 Ceedling 宝石 v0.28.1 引入的更改行为
使用 Ceedling 的最新版本意味着您可以使用 ceedling test:all 而不是 rake test:all 这样的命令。如果您有一个持续集成服务器或其他调用服务,它可能需要更新以保持兼容。
类似地,较老版本的 Ceedling 实际上在项目目录中放置了一个 rakefile,允许项目自定义自己的流程。这部分没有被使用,后来引入了更好的方法。此时,rakefile 的麻烦多于其价值,通常应该直接删除。
有关详细信息,请参阅 CeedlingUpgrade.md。
要求
要使用 Ceedling 插件,您需要:- 由 Ceedling 支持的 Ruby 版本(推荐使用 3.0.x)- GCC 编译器用于默认构建- Ceedling 0.28.1 或更高版本(已使用 0.31.1 进行测试)
项目 Wiki 包含有关 安装要求 的更多信息。
安装
插件
安装适用于 ST3+ 的 Ceedling 插件的推荐方法是使用 Package Control。
安装 Package Control 后
- 打开命令面板
- 选择
Package Control: Install Packages
- 输入
Ceedling
- 单击包列表进行安装。
Unity 测试断言现在由 Unity Test Completions
包提供。此包推荐安装。
一步安装两个包:- 打开命令面板 - 选择 Package Control: Advanced Install Packages
- 输入 Ceedling, Unity Test Completions
- 按回车键
当你启动 Sublime Text 时,它会获取这些包的内容,以便你可以享用它们提供的便利。
特性
新建项目
新建项目
有两种版本。
- 默认的
Ceedling: 新建项目
包含基本安装,包括project.yml
、src
和test
文件夹。 Ceedling: 新建项目 (本地)
添加一个ceedling
可执行脚本,以及包含 Ceedling 框架当前版本的vendor
目录。
创建新项目
- 打开命令面板(工具 > 命令面板),然后输入
cnp
以缩小选项范围。 - 选择
Ceedling: 新建项目
或Ceedling: 新建项目 (本地)
- 将打开一个新的窗口
在面板中输入项目文件夹的位置。
例如
~/projects/drsurly
将在projects
文件夹内创建一个名为drsurly
的项目文件夹。~
扩展到当前用户的家目录。按回车键。
项目文件夹应在当前窗口中打开。
定制新建项目创建
新项目的默认父文件夹默认设置为 ~
。
要更改默认文件夹,打开 Ceedling 设置 首选项
> 包设置
> Ceedling
> 设置
。
将以下条目添加到 User Settings
中,根据需要更新路径,然后保存。
{
"default_project_folder": "~/path/to/parent/folder/",
"project_options": ["--gitignore", "--docs"]
}
project_options
提供对项目创建的额外控制。
选项默认已禁用。将选项添加到 project_options
中将启用它。
--docs "Add docs in project vendor directory"
--local "Create a copy of Ceedling in the project vendor directory"
--gitignore "Create a gitignore file for ignoring ceedling generated files"
--no_configs "Don't install starter configuration files"
将 Ceedling 添加到现有项目
可以使用 新建项目
模块将 Ceedling 支持添加到现有源代码。在此过程中,现有文件和文件夹不会被覆盖或修改。当提示位置时,使用现有项目的路径。
创建新模块
现在 创建新模块
命令使用相对项目文件夹的路径。
指定 basename
将默认生成 test/test_basename.c
、src/basename.h
和 src/basename.c
文件。
支持使用缩写格式标识符使用额外的命名方案。
缩写 | 命名方案 | 文件 |
---|---|---|
src | 头文件、源文件、测试(默认) | 3 |
test | 仅测试文件 | 1 |
mch | 模型、导体、硬件 | 9 |
mvp | 模型、视图、表现者 | 9 |
dhi | 驱动器、硬件、中断 | 9 |
dh | 驱动器、硬件 | 6 |
mch
、mvp
、dhi
和 dh
方案为每个命名模块生成头文件、源文件和测试文件。
运行测试
使用 Sublime Text 构建系统来运行所有测试。
从 工具
> 构建系统
菜单中选择 Ceedling
作为项目的构建系统。
变体 | Ceedling 任务 | 注意 |
---|---|---|
默认 | test:filename |
测试当前模块 |
测试全部 | test:all |
测试所有模块 |
测试变更 | test:delta |
测试变更的模块 |
仅测试构建 | test:build_only |
构建全部,不测试 |
清理和测试文件 | clean test:filename |
|
发布 | release |
新项目.yml 中已禁用发布配置。 |
使用 Control-Shift-B
(Windows、Linux)/Command-Shift-B
(macOS)选择变体。
使用 Control-B
(Windows、Linux)/ Command-B
(macOS) 运行最后选择的构建变体。
命令
命令名称 | 描述 |
---|---|
Ceedling: 新建项目 | ceedling 新名称 |
Ceedling: 新建项目 (本地) | ceedling --local 新名称 |
Ceedling: 清理项目 | ceedling clean |
Ceedling: 覆盖项目 | ceedling clobber 删除所有生成的文件,包括日志 |
Ceedling: 创建新模块 | ceedling create:模块名称 |
Ceedling: 销毁当前模块 | 关闭与当前文件关联的所有测试、源和头文件的视图,然后调用 ceedling destroy:模块名称 |
Ceedling: 打开模块头文件 | 打开当前模块的头文件 |
Ceedling: 打开模块源文件 | 打开当前模块的源文件 |
Ceedling: 打开模块测试文件 | 打开当前模块的测试文件 |
Ceedling: 打开下一个模块文件 | 循环遍历当前模块的头文件、源文件和测试文件 |
Ceedling: 打开模块文件 | 在2列布局中打开当前活动文件的测试、源、头文件 |
Ceedling: 切换日志记录 | 切换当前日志记录设置 |
Ceedling: 切换详细输出 | 切换详细输出 |
Ceedling: 编辑项目配置 | 打开 project.yml |
Ceedling: 测试摘要 | 打印之前运行的测试摘要 |
Ceedling: 版本 | 打印当前项目使用的ceedling版本信息 |
Ceedling: 环境 | 显示ceedling设置的ENV变量 |
键映射
注意:键映射默认禁用。
键命令 | 功能 |
---|---|
ctrl+super-h |
打开头文件 |
ctrl+super-s |
打开源文件 |
ctrl+super-t |
打开测试文件 |
ctrl+super-. |
以2列布局打开模块文件 |
ctrl+super-right |
循环遍历模块文件 |
要使用这些键映射,请转到 首选项 » 包设置 » Ceedling » 键绑定
。从左侧面板复制带注释的绑定到右侧的 用户 Default.sublime-keymap
,然后选择并选择 编辑 » 注释 » 切换块注释
以取消注释。
有关设置键分配的更多信息,请参阅键绑定 文档。
代码片段
现在,Unity测试代码片段由 Unity Test Completions
包提供。该包提供了467个代码片段,覆盖了99.79%的Unity测试。
可以使用PackageControl安装Unity Test Completions包。- Unity Test Completions