TourBus 技术文档

本文档将详细介绍如何安装、使用以及操作 TourBus，这是一个灵活且可扩展的网站测试工具。

1. 安装指南

系统要求

• Ruby 1.8.7 或更高版本（建议使用 2.x 版本）
• Mechanize 0.9 或更高版本
• Webrat 测试框架

安装步骤

1. 确保系统已安装 Ruby 环境。
2. 使用 gem install tourbus 命令安装 TourBus。
3. 安装 Mechanize 和 Webrat：

   gem install mechanize
   gem install webrat
   

2. 项目使用说明

创建测试脚本

1. 在项目根目录下创建一个名为 tours 的文件夹。
2. 在 tours 文件夹中创建测试脚本，例如 simple.rb。以下是示例代码：

   class Simple < Tourist
     def tour_homepage
       visit "http://#{@host}/"
       assert_contain "我的主页"
     end
   end
   

运行测试

• 运行单个测试：

  tourbus -c 2 -n 3 simple
  

  这将创建 2 个并行的测试运行器，每个运行器将执行 Simple 类中的所有方法 3 次。
• 运行多个测试：

  tourbus -c 2 -n 3 simple1 simple2 simple3
  

• 如果不指定测试，将运行 tours 文件夹中的所有测试。

过滤测试

• 过滤特定测试：

  tourbus -c 2 -n 3 simple -t test_login,test_logout
  

3. 项目API使用文档

TourBus 的 API 主要围绕 Tourist 类和测试脚本的编写。以下是一些关键的 API：

• visit(url): 访问指定的 URL。
• assert_contain(text): 断言页面包含指定的文本。

更多 API 文档可以在官方 GitHub 仓库中找到。

4. 项目安装方式

除了使用 gem install tourbus 的方式安装外，还可以通过以下步骤手动安装：

1. 克隆 GitHub 仓库：

   git clone https://github.com/dbrady/tourbus.git
   

2. 进入克隆的目录：

   cd tourbus
   

3. 执行 setup.rb 脚本：

   ruby setup.rb
   

以上是关于 TourBus 的基本安装和使用说明。更多信息，请参考官方文档和 GitHub 仓库。