Ruby Spec Suite 技术文档

1. 安装指南

1.1 克隆项目

首先，克隆 ruby/spec 项目到本地：

$ git clone https://github.com/ruby/spec.git

1.2 进入项目目录

进入克隆下来的项目目录：

$ cd spec

1.3 克隆 MSpec 项目

克隆 MSpec 项目到本地：

$ git clone https://github.com/ruby/mspec.git ../mspec

2. 项目的使用说明

2.1 运行所有测试

在项目目录下，运行以下命令来执行所有的测试：

$ ../mspec/bin/mspec

2.2 运行特定测试

你可以通过指定文件或目录来运行特定的测试。例如，运行单个测试文件：

$ ../mspec/bin/mspec core/kernel/kind_of_spec.rb

或者运行某个目录下的所有测试：

$ ../mspec/bin/mspec core/kernel

2.3 按组运行测试

你还可以按组运行测试，例如运行所有语言相关的测试：

$ ../mspec/bin/mspec :language

其他组的测试可以通过以下命令运行：

$ ../mspec/bin/mspec :core
$ ../mspec/bin/mspec :library
$ ../mspec/bin/mspec :capi

3. 项目API使用文档

3.1 运行特定Ruby实现的测试

使用 -t 选项来指定要运行的Ruby实现。你可以传递Ruby二进制文件的完整路径或 $PATH 中的可执行文件：

$ ../mspec/bin/mspec -t /path/to/some/bin/ruby

3.2 启用内存泄漏检查

你可以通过设置 CHECK_LEAKS=true 来启用内存泄漏检查：

$ CHECK_LEAKS=true ../mspec/bin/mspec

3.3 在S390x架构上运行测试

如果在S390x架构上运行测试时遇到与zlib库相关的失败，可以通过设置 DFLTCC=0 来解决：

$ DFLTCC=0 ../mspec/bin/mspec

4. 项目安装方式

4.1 依赖项

运行测试需要以下命令行工具：

• echo
• stat（用于 core/file/*time_spec.rb）
• find（用于 core/file/fixtures/file_types.rb，在Windows上不需要）

此外，/etc/services 文件是套接字测试所必需的（在Debian上需要 netbase 包，在Windows上不需要）。

4.2 历史版本

如果你需要运行旧版本的Ruby测试，可以参考项目中的历史提交记录，选择相应的提交版本进行测试。

5. 贡献与编写测试

5.1 贡献指南

有关贡献和编写测试的详细信息，请参阅 CONTRIBUTING.md 文件。

5.2 编写测试

编写测试时，可以使用 guards、matchers 等工具来帮助编写和运行测试。