Culerity 项目技术文档

1. 安装指南

1.1 安装 JRuby

首先，下载并解压 JRuby 到指定目录，例如 $HOME/jruby。确保 jruby 可执行文件在系统路径中。可以通过以下两种方式之一来设置路径：

• 通过设置环境变量：

  export PATH=$HOME/jruby/bin:$PATH
  

• 或者创建符号链接：

  ln -s $HOME/jruby/bin/jruby /usr/bin/jruby
  

1.2 安装 Celerity Gem

在 JRuby 环境中安装 Celerity gem：

jruby -S gem install celerity

1.3 安装 Culerity Gem

安装 Culerity gem：

gem install culerity --source http://gemcutter.org

1.4 生成 Cucumber 和 Culerity 文件

假设你已经有一个 Rails 应用程序，进入项目根目录并运行以下命令生成必要的文件：

cd RAILS_ROOT
script/generate rspec
script/generate cucumber
script/generate culerity

这将创建 features 文件夹，并在其中生成 celerity_steps.rb 文件。

1.5 清理 Webrat 相关文件

删除 Cucumber 生成的 Webrat 相关文件（例如 features/step_definitions/webrat_steps.rb）。

2. 项目的使用说明

2.1 运行测试

在运行 Culerity 测试之前，需要启动一个测试环境下的 Web 服务器（例如 Mongrel）：

rake culerity:rails:start

然后运行 Cucumber 测试：

cucumber features/my_feature.feature

2.2 停止服务器

测试完成后，停止 Rails 实例：

rake culerity:rails:stop

2.3 注意事项

• 默认端口为 3001，可以在 features/step_definitions/common_celerity.rb 中修改。
• 如果使用 RVM，可以参考 RVM 集成指南。

3. 项目 API 使用文档

3.1 选择元素

Celerity 提供了多种选择元素的方法，具体可以参考 Celerity 文档。

3.2 常见问题

• Broken Pipe 错误：确保 JRuby 已安装并正确配置。
• Connection Refused 错误：确保测试环境下的服务器已启动并监听端口 3001。
• 数据无法找到：确保在 env.rb 中禁用了事务性 fixtures。
• 数据库未自动清理：由于禁用了事务性 fixtures，需要手动清理数据库。

4. 项目安装方式

4.1 安装依赖

• 安装 JRuby。
• 在 JRuby 中安装 Celerity gem。
• 安装 Culerity gem。

4.2 生成文件

• 使用 Rails 生成器生成 RSpec、Cucumber 和 Culerity 相关文件。

4.3 配置环境

• 确保 JRuby 和 Celerity 正确配置。
• 启动测试环境下的 Web 服务器。

通过以上步骤，你可以成功安装并使用 Culerity 项目进行全栈测试。