NAME

OpenResty::Spec::RunTestsOnWin32_cn - Running the OpenResty test suite on Win32

DESCRIPTION

本文档介绍了如何在 Win32 上建立一个 OpenResty 测试集的运行环境，测试本地的或者远方的 OpenResty 服务器。

安装perl

从下面的位置下载 AgentPerl 安装程序（推荐使用 FlashGet 这样的多线程下载器）：

http://agentzh.org/misc/win32/AgentPerl.exe

下载完毕后，双击即开始安装过程。应注意安装过程中不要轻易修改默认的设置，除非您知道自己在做什么 ;)

使用 ActiveState 的 ActivePerl 亦可，只不过需要手动安装一些 CPAN 模块，比如 Class::Prototyped, Test::LongString, Text::Diff, LWP::UserAgent, HTTP::Response, Cache::Cache, 以及 WWW::OpenResty.

Checkout OpenResty 源码

1. 首先安装 TortoiseSVN. TortoiseSVN 安装程序可以从 TortoiseSVN 官方网站取得。

2. 取得 OpenResty 的 SVN head

   在 TortoiseSVN 中 checkout 下面的地址：

   http://svn.openfoundry.org/openapi/trunk

   比如 checkout 到的地址目录是 C:\openresty.

编辑配置文件

1. 将 C:\openresty\etc\openresty.conf 复制成同一目录下的 site_openresty.conf 文件.

2. 编辑 site_openresty.conf 文件中的 [test_suite] 下的配置项，将 use_http 置为 1 （默认为 0)，将 server 和 server2 选项更改为您自己的测试帐户，密码，以及主机名，一个例子是：

     server=tester:password@api.openresty.org
     server2=tester2:password2@api.openresty.org

   运行 OpenResty 测试集需要两个 OpenResty 测试帐户。因为有一些测试是针对跨帐户操作的。

运行测试集

1. 首先在 [开始] -> [运行] 对话框输入 cmd 启动 Win32 的命令行终端.

2. 然后用下面的命令把当前工作目录切换到您先前 checkout 出来的本地目录，比如 C:\openresty:

        cd /d C:\openresty

3. 运行整个测试集的方法是

        C:\openresty> prove -Ilib -r t

运行测试的其他方式

• 有选择地运行单个测试脚本的方法是：

       prove -Ilib t/01-sanity.t

• 运行任意一组测试亦是可能的，例如：

      prove -Ilib t/01-sanity.t t/02-chunwen.t

  或者使用通配符：

      prove -Ilib t/0*.t

• 如果想运行某个测试文件中的单个用例，可以在该用例最后添加一行

    --- ONLY

• 如果想运行到某个测试用例就结束（即跳过后面的所有用例），可以在那个用例的末尾添加一行

    --- LAST

• 对于调试测试本身时添加的 --- ONLY, --- LAST 等标签应当在调试结束后去除，不应提交到 SVN 仓库中去。

• 如果想暂时跳过某个测试用例，可以使用 --- SKIP 标签。

提交新的测试用例

原则上不应随便修改现有的测试用例，推荐新添加的测试可以放到专门的 .t 文件中（按序号和功用正确命名）。

AUTHOR

Agent Zhang (章亦春) <agentzh@yahoo.cn>

LICENSE

  Copyright (c)  2007  Yahoo! China (中国雅虎公司).
  Permission is granted to copy, distribute and/or modify this document
  under the terms of the GNU Free Documentation License, Version 1.2
  or any later version published by the Free Software Foundation;
  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
  Texts. A copy of the license can be found at

    http://www.gnu.org/licenses/fdl.html

SEE ALSO

OpenResty::Spec::TestSuite, OpenResty.