Test Daemon 技术文档

1. 安装指南

安装步骤

1. 将 tdaemon 文件放置在一个可执行的路径中。
2. 确保系统中已安装 Python 环境。
3. 如果需要使用特定的测试工具（如 nosetests、py.test 等），请确保这些工具已安装在系统中。

2. 项目使用说明

基本用法

在终端中运行以下命令，启动 tdaemon：

$ python /path/to/tdaemon.py

tdaemon 会开始监视当前目录及其子目录中的文件。一旦检测到文件内容发生变化，tdaemon 会自动运行 nosetests 并显示测试结果。

高级用法

更改扫描路径

如果希望从其他目录启动 tdaemon，可以使用以下命令：

$ tdaemon.py /path/to/your/project

更改测试程序

默认情况下，tdaemon 使用 nosetests 作为测试程序。如果希望使用其他测试程序，例如 py.test，可以使用以下命令：

$ tdaemon.py --test-program=py

支持的测试程序及其关键字如下：

• nosetests（关键字为 nose 或 nosetests）
• django（关键字为 django）
• py.test（关键字为 py）
• symfony（关键字为 symfony）
• jelix（关键字为 jelix）
• phpunit（关键字为 phpunit）
• sphinx（关键字为 sphinx）
• tox（关键字为 tox）

注意：使用这些测试程序前，请确保它们已安装在系统中。

添加测试程序的参数

大多数测试程序允许使用特定参数进行测试。如果希望为测试程序添加自定义参数，可以使用 --custom-args 参数，例如：

$ tdaemon.py --custom-args="myapp.MyTestClass" --test-program=django

上述命令将在当前目录下执行以下命令：

$ ./manage.py myapp.MyTestClass

请参考相应测试程序的文档，了解可用的额外参数。

警告：使用此选项时，系统会要求您确认操作。任何可能导致系统损坏或数据丢失的命令均由用户自行负责。

设置最大文件大小

tdaemon 首先检查要扫描的文件总大小。如果总文件大小超过默认的 25MB 限制，程序会询问您是否继续。您可以通过 --size-max 参数更改此限制，例如：

$ tdaemon --size-max=100

此参数将限制程序仅在总文件大小超过 100MB 时询问用户是否继续。

3. 项目API使用文档

tdaemon 主要通过命令行参数进行配置和使用，没有提供额外的 API 接口。所有功能均通过命令行选项实现。

4. 项目安装方式

tdaemon 的安装方式非常简单，只需将 tdaemon.py 文件放置在系统路径中，并确保 Python 环境已正确安装。如果需要使用特定的测试工具，请确保这些工具已安装在系统中。

依赖项

• Python 环境
• 可选：nosetests、py.test、django 等测试工具

安装命令

$ cp tdaemon.py /usr/local/bin/tdaemon
$ chmod +x /usr/local/bin/tdaemon

完成上述步骤后，您就可以在终端中直接使用 tdaemon 命令了。