M.RB 项目技术文档

本文档旨在帮助用户安装、使用和理解 M.RB 项目。M.RB 是一个改进的测试运行器，允许用户通过行号运行测试，适用于 Test::Unit 和 minitest 等测试框架。

1. 安装指南

M.RB 可以通过以下命令安装：

gem install m

如果您使用 Bundler，需要在 Gemfile 中添加以下代码：

group :test do
  gem "m"
end

安装完成后，可以通过以下命令检查是否安装成功：

m --version

2. 项目使用说明

M.RB 允许用户通过行号运行测试，下面是具体的使用方法：

运行单个测试

给定以下测试文件：

require 'test/unit'

class ExampleTest < Test::Unit::TestCase
  def test_apple
    assert_equal 1, 1
  end

  def test_banana
    assert_equal 1, 1
  end
end

您可以使用以下命令运行特定行号的测试：

m test/example_test.rb:4

如果输入了错误的行号，M.RB 会提示您正确的测试行号：

m test/example_test.rb:2

输出结果：

No tests found on line 2. Valid tests to run:

 test_apple: m test/example_test.rb:4
test_banana: m test/example_test.rb:8

运行所有测试

如果要运行整个测试文件，只需省略行号：

m test/example_test.rb

递归运行测试

如果要运行一个目录及其子目录中的所有测试，可以使用 -r 标志：

m -r test/models

传递选项

如果需要传递选项到实际的测试运行器，可以使用 -- 标志：

m test/models -- --seed 1234

确保使用 -- 作为最后一个参数，否则会收到无效选项错误。

3. 项目API使用文档

M.RB 的 API 文档在官方 GitHub 仓库的 wiki 页面上提供。由于这里无法提供具体的 API 文档，请参考项目仓库的 wiki 页面获取详细信息。

4. 项目安装方式

M.RB 可以通过 Ruby 的包管理器 gem 进行安装。请按照以下步骤操作：

1. 打开命令行工具。
2. 输入 gem install m 命令进行安装。
3. 如果使用 Bundler，将 gem "m" 添加到 Gemfile 的 test 组中。
4. 运行 bundle install 来安装所有依赖。

以上就是 M.RB 项目的技术文档，希望对您的使用有所帮助。