one9 使用与技术文档

1. 安装指南

要安装one9工具，您可以使用以下命令：

$ gem install one9

如果您正在使用bundler（Rails3中的默认值），请将one9添加到您的Gemfile中，特别是如果您的测试是由bundler调用的。例如：

gem 'one9'

2. 项目的使用说明

one9是一个命令行工具，用于帮助您将Ruby 1.8.7代码转换为1.9.2版本。它通过监视您的测试并检测1.9中的更改来实现。当您的测试套件完成时，one9将打印一个报告，列出在1.9中发生变化的方法的精确位置。为了使过渡更加容易，one9还可以在编辑器中打开这个列表。

• 使用以下命令运行测试：

$ one9 test

默认情况下，这会运行rake test。

• 如果您想运行特定的测试命令，只需在前面加上one9 test：

$ one9 test cucumber
$ one9 test rspec spec/models

测试完成后，您将看到一个报告。以下是运行示例：

...
300 tests, 580 assertions, 0 failures, 0 errors

** One9 Report **
+---------------------------------+-------+--------------------------------------------------------------+--------+--------------------------------------------------------------+
| method                          | count | message                                                      | type   | lines                                                        |
+---------------------------------+-------+--------------------------------------------------------------+--------+--------------------------------------------------------------+
| Module#instance_methods         | 5     | 返回符号数组而不是字符串数组                                 | 更改   | lib/boson/util.rb:39:in `detect',lib/boson/util.rb:40:in ... |
| Module#private_instance_methods | 2     | 返回符号数组而不是字符串数组                                 | 更改   | lib/boson/inspectors/argument_inspector.rb:23:in `scrape_... |
| Hash#to_s                       | 4     | 是#inspect的别名，而不是对元素的空格连接                       | 更改   | lib/boson/loader.rb:87:in `initialize_library_module',lib... |
| Hash#select                     | 4     | 返回哈希而不是关联数组                                       | 更改   | lib/boson/loader.rb:109:in `set_library_commands',lib/bos... |
+---------------------------------+-------+--------------------------------------------------------------+--------+--------------------------------------------------------------+

• 要编辑这些可能的更改，使用以下命令：

$ one9 edit

或者只打开一个子集的更改：

$ one9 edit Hash
$ one9 edit Hash#to_s

目前，这将在vim中打开快速修复列表。如果您使用的编辑器不受支持，可以查看可能的更改：

$ one9 files

3. 项目API使用文档

one9的API使用非常简单。以下是一些基本的使用案例：

• 运行测试并生成报告：

$ one9 test

• 编辑报告中的更改：

$ one9 edit

• 查看可能更改的文件列表：

$ one9 files

• 添加自定义更改到~/.one9rc文件：

change 'Class#instance_method', '一些描述'
delete 'Class.class_method', '一些描述'

4. 项目安装方式

项目的安装方式如前所述，使用gem install one9进行安装。如果您使用bundler，请将one9添加到Gemfile中。

---

本文档旨在帮助用户安装、使用和了解one9项目，以便更好地进行Ruby代码迁移和升级工作。