aet - 云端在线

程序：

您的姓名

aegis 测试 - 运行测试

概要

庇护 -测试 [ 选项...][ 姓名=折扣值 ][ 文档名称...]
庇护 -测试 -独立的 [ 选项...][ 姓名=折扣值 ][ 文档名称...]
庇护 -测试 -列表 [ 选项...]
庇护 -测试 -帮助

商品描述

庇护 -测试 命令用于运行测试。 如果没有命名文件，则所有相关测试
正在运行。 默认情况下，自动和手动测试都会运行。

您可以在命令行上命名目录，以及该目录中的所有相关测试
将运行更改中的树。 如果没有相关测试是错误的。

每个架构都必须单独测试。 这是因为可能有微妙的
仅在某些架构上显示的问题。 有些项目可能还有
不同架构的不同代码。

上次测试运行的状态会被记住，这样如果没有测试就不会运行
需要。 （这不适用于 -回归 不幸的是，测试。）必须重新运行测试
如果之前的测试失败，如果测试文件已经改变，如果有构建，
和每个架构。

名称=值
您可以添加 姓名=折扣值 对到命令行，这些将不变地传递给
测试命令。 通常在命令行的末尾，但这可以在
项目配置文件。

-力 选项导致一个隐式 force=1 变量被添加到列表中
变量赋值，因此添加到命令的末尾。 这是最有用的时候
使用 批处理测试命令 项目配置文件的字段。

这可能最初看起来像一个最终运行的开发过程，允许测试脚本
这样他们就可以在不实际做任何事情的情况下给出所有正确的答案。 你
一直能够使用环境变量来做到这一点，所以这不是什么新鲜事。

可以将所有的变量赋值变成环境变量
通过将 $var 放在 开始 命令的名称，在 shell 名称之前，而不是在
命令末尾的默认位置。

文件 名字 解释
aegis 程序将尝试从文件名中确定项目文件名
在命令行中给出。 所有文件名都作为相对文件名存储在 aegis 项目中
到基线目录树的根。 开发目录和
集成目录是这个基线目录的影子，所以这些相对名称
也在这里申请。 命令行中命名的文件首先转换为绝对路径
如有必要。 然后将它们与基线路径、开发目录进行比较
path 和集成目录路径，以确定相对于基线的名称。 这是
如果命名的文件在这些目录树之一之外，则会出现错误。

-BASE_Relative 选项可用于将相对文件名解释为
相对于基线路径； 绝对文件名仍将与各种
路径以确定基线相对名称。

相对文件名首选项 在用户配置文件中可以用来修改
这种默认行为。 看 配置文件(5) 了解更多信息。

测试 PROCESS

每次更改都需要伴随测试，而这些测试需要
针对构建的开发目录运行，它们必须通过。 这确保了新
功能伴随着测试以验证其正确性，并且错误修复是
伴随着确认错误已修复的测试。

数据复原测试 检测
测试被视为任何其他源文件，并在基线和
所有其他源文件的历史记录。 必须伴随每次更改的测试
在项目基线中积累，为项目提供正确功能的定义
基线。 这些累积的测试可以使用“aegis -REgression”命令执行，
验证项目不会因变更而“倒退”。

底线 检测
需要修复错误才能进行测试 失败 相对于项目基线（相反
到开发目录）。 这确保测试实际演示了错误
在基线中，并证明它已被更改固定。 新的
功能在基线上很容易失败，因此 aegis 不会尝试
猜测测试是错误修复测试还是新功能测试，它只需要测试
不符合基线。

此要求既适用于由更改创建的新测试，也适用于测试
已复制到更改中进行修改。

回顾 检测
审阅者可能确信 aegis 已执行测试要求； 那是一种改变
必须有测试，更改必须构建，测试通过对开发
目录，并且测试在基线上失败。 这些条件被强制执行
by 伊蚊(1) 并且更改不会提前到 作为 审查 状态直到这些
条件满足。 因此，审查者应该审查测试 完整性 的覆盖范围
更改中的代码，以及对执行环境中的更改不敏感（例如
日期不敏感）。 审稿人还应该使用“aegis -list change_details”来验证
更改是否具有测试豁免。

豁免
项目管理员可能会授予各种测试豁免，请参阅 环保局（1）和
埃帕特(5) 了解更多信息。 将测试复制到更改中，或将新测试添加到
更改，可能会取消这些豁免。

测试 指挥 配置

用于执行测试的命令由 测试命令 项目中的字段
配置文件（见 配置文件(5) 有关更多信息），这默认使用
如果未设置 Bourne 外壳。 当前目录将是适当的顶部
目录树。 如果测试需要临时文件，他们应该在 / tmp目录， 作为一个
test 不能期望在当前目录中有写权限。

如果你想使用更复杂的测试引擎，而不是简单的 shell 脚本，
但是这个测试引擎不返回适合与 aegis 一起使用的结果代码，你可以
将其包装在一个 shell 脚本中，该脚本将退出状态重写为 aegis 期望的值。
您也可以通过编写更复杂的代码来获得相同的结果 测试命令 ，在
项目 配置 文件中。

也可以编写能够测试多个文件的测试命令
一次。 这是由 批处理测试命令 项目领域 配置 文件。 在
在这种情况下， ${output} 替换表示测试命令必须的文件名
创建，在 艾泰斯特(5) 格式，包含测试运行的结果。 这是经常使用的
在具有多个 CPU 或能够在多台计算机上分配作业的系统上
在网络上。

替换
所有的 亚瑟(5) 替换在测试命令中可用。 他们之中有一些是
特别注意：

建筑学
此替换由要测试的体系结构的名称替换。

搜索路径
此替换由冒号分隔的绝对路径列表替换
在查找测试支持文件时进行搜索。

搜索路径可执行文件
此替换由冒号分隔的绝对路径列表替换
在查找可执行支持文件（库文件和子文件）时进行搜索
命令）。

大多数时候 $Search_Path_Executable 完全一样。 但是，在“aegis -t
-bl” 他们会有所不同，与 $搜索路径 从开发目录开始（
测试正在运行）和 $Seach_Path_Executable 从基线开始（可执行文件是
跑）。

测试 结果 代码
随着每个测试的运行（通过 测试命令 项目中的字段 配置 文件), aegis
通过查看其退出状态来确定测试是成功还是失败。 这个出口
status 主要与 UNIX 命令的预期一致。

成功
一个测试应该退出 0 表示成功，即被测试的特定功能
按预期工作。

失败
一个测试应该退出 1 来表示失败，即被测试的特定功能
没有按预期工作。

没有结果
测试应退出 2 以指示没有结果， 即 下的具体功能
由于其他问题，无法进行测试。 例如，运行
在创建测试输入文件时磁盘空间不足 / tmp目录 目录。

跳过
测试应退出 77 以指示它已被跳过。 这通常与
当前的架构没有意义。 尽可能使用“无结果”
反而。 （选择该值是为了与其他测试系统兼容。）

实际上，除 0、1 或 77 之外的任何退出代码都将被解释为“无结果”。
然而，总是使用 0、1、2 或 77 意味着如果一个新的结果代码被一个
以后发布的 Aegis 您现有的测试将继续工作。

测试 相关性

“aegis -Test -SUGgest”命令可用于让 aegis 建议合适的回归
根据更改中的源文件对更改进行测试。 这自动
将测试工作集中在相关测试上，减少回归测试的数量
有必要确信您没有引入错误。

测试相关性由“aegis -Integrate_Pass”命令生成，该命令
将变更中的每个测试与变更中的每个源文件相关联。 因此，每个
源文件累积了过去与其关联的测试列表。
这不像代码覆盖率分析那么精确，但在以下情况下是一个合理的近似值
实践。

欧共体（1）和 恩夫(1) 命令用于将文件与更改相关联。 虽然他们
不主动执行关联，这些是使用的文件 通行证（1）和
AET(1) 确定哪些源文件与哪些测试相关联。

测试 相关 准确性
假设测试相关性是准确的并且测试是均匀的
分布在整个功能空间中，将有一个小于 1/号 一个机会
“aegis -Test -SUGgest”尚未运行相关测试 数“ 命令。 一个小的
噪声量被添加到测试权重中，因此有时会出现意想不到的事情
经过测试，并且不会每次都运行相同的测试。

通过确保：

· 每次更改都应重点关注，不得包含无偿的文件。 这个
避免虚假的相关性。

· 每一项新功能都应该在单独的更改中添加，而不是
几个在一起。 这将测试与功能密切相关。

· 每个错误都应该在单独的更改中修复，而不是几个一起更改。 这个
将测试与功能强相关。

· 如果移动文件，测试相关性将丢失。 这是因为相关性是由
名称。

测试与源文件准确关联的最佳方式是
包含一个测试以及与被测功能相关的那些文件。 也
许多虚假文件会削弱测试相关性的有用性。

配置

理解以下选项：

-自动的
此选项可用于指定自动测试。 自动测试不需要
人力援助。

-基线
此选项可用于指定项目基线是
命令。

-BASE_Relative
此选项可用于导致相对文件名被视为相对于
源树的基础。 看 配置文件(5) 对应用户
偏好。

-CUrrent_Relative
此选项可用于导致相对文件名被视为相对于
当前目录。 这通常是默认设置。 看 配置文件（5）
相应的用户偏好。

-改变 数
此选项可用于指定项目中的特定更改。 看
庇护(1) 有关此选项的完整说明。

-力量 此选项可用于指定应运行所有测试，即使
上次测试运行的状态表明不需要运行特定的
测试。

-帮助
此选项可用于获取有关如何使用 庇护
程序。

-独立的
此选项用于指定测试将独立于任何
特别的变化。 如果未命名测试，则将运行基线中的所有测试。

-列表
此选项可用于获取此命令的合适主题列表。
该列表可能比预期的更笼统。

-手动的 此选项可用于指定手动测试。 手动测试需要一些人工
干预，例如：确认某些屏幕行为（例如 X11），或
一些用户操作，“现在拔掉以太网电缆”。

-Not_Logging
此选项可用于禁用输出和错误的自动记录到
一份文件。 当多个 aegis 命令组合在一个 shell 中时，这通常很有用
脚本。

-坚持
此选项可用于指定应运行所有测试，即使某些测试
失败。 默认为用户的 坚持不懈 如果未指定，请参阅
配置文件(5) 了解更多信息。

-No_PERsevere
此选项可用于指定测试运行应在第一次运行后停止
失败。 默认为用户的 坚持不懈 如果未指定，请参阅
配置文件(5) 了解更多信息。

-项目 姓名
此选项可用于选择感兴趣的项目。 当没有 -项目
选项被指定， 宙斯盾项目 环境变量被咨询。 如果
不存在的，用户的 $HOME/.aegisrc 检查默认文件
项目字段（见 配置文件(5) 了解更多信息）。 如果那不存在，
当用户只在单个项目中进行更改时，项目
名称默认为该项目。 否则，这是一个错误。

-进步
此选项可用于指定应在之前发出进度消息
每次测试运行或每次批量测试运行之前，以防万一 批处理测试命令 部分
项目中指定 配置 文件（见 配置文件(5) 了解更多信息）。

-没有进展
此选项可用于指定应抑制进度消息。
这是默认设置。

-回归
此选项用于指定要运行的回归测试套件。 这
回归测试套件包含基线中未出现的所有测试
在变化中。 如果没有回归测试，这是一个错误。 你不可以
使用 -REgression 选项时，命令行上的名称测试。 你可以命名
在命令行上运行的单个测试，不使用 -REgression
选项; 如果它们不是更改的一部分，则在
将运行基线。

-建议 [ 数 ]
“”庇护 -Integrate_Pass”命令收集测试相关统计信息时
变化是集成的。 此选项可用于请求 aegis 建议
使用这些测试相关性，应该运行哪些测试。 如果没有数字
指定，建议进行 10 次测试。 该选项意味着 -回归
选项。

-SUGgest_Limit 分钟
此选项可用于将测试数量限制为一定数量
分钟。 它们将从最相关到​​最不相关。

-SUGgest_Noise 数
此选项可用于控制注入测试的噪声量
由执行的选择 -建议 选项。 数字是噪音的百分比
被注射。 如果未指定，则默认为 10。 噪声的注入确保
在后续运行中运行各种测试，还有一些来自左场
作为健全性检查。

-TERse
此选项可用于使列表产生最少的
信息。 它通常对 shell 脚本很有用。

-详细
此选项可用于使 aegis 产生更多输出。 默认情况下
只产生错误的输出。 当与 -列表 选项这个选项
导致添加列标题。

-等待 此选项可用于要求 Aegis 命令等待访问锁定，如果
它们不能立即获得。 默认为用户的 锁等待偏好
如果未指定，请参阅 配置文件(5) 了解更多信息。

-No_Wait
此选项可用于要求 Aegis 命令在访问时发出致命错误
不能立即获得锁。 默认为用户的
锁等待偏好 如果未指定，请参阅 配置文件(5) 了解更多信息。

参见 庇护(1) 对于所有 aegis 命令通用的选项。

所有选项都可以缩写； 缩写记录为大写字母，
所有小写​​字母和下划线 (_) 都是可选的。 您必须使用连续
可选字母的序列。

所有选项都不区分大小写，您可以将它们输入为大写或小写或
两者结合，大小写并不重要。

例如：参数“-project”、“-PROJ”和“-p”都被解释为表示
-项目 选项。 参数“-prj”不会被理解，因为连续
未提供可选字符。

选项和其他命令行参数可以在命令行上任意混合，
在功能选择器之后。

GNU 长选项名称是可以理解的。 由于所有选项名称为 庇护 很长，
这意味着忽略额外的前导“-”。 这 ”--选项=折扣值"约定也是
明白了。

推荐 别名

此命令的推荐别名是
csh% 别名 aet 'aegis -t \!* -v'
sh$ aet(){aegis -t "$@" -v}

错误

如果更改不在其中之一中，则为错误 作为 发达 or 作为 集成
状态。
如果未将更改分配给当前用户，则会出现错误。
如果您没有相关测试和相关豁免，则是错误的。

退出 状态

庇护 命令将在出现任何错误时以 1 状态退出。 这 庇护 命令只会
如果没有错误，则退出状态为 0。

环境 变数

我们 庇护(1) 获取可能影响此命令的环境变量列表。 看
配置文件(5)为项目配置文件的 项目特定 字段如何设置
Aegis 执行的所有命令的环境变量。

使用 onworks.net 服务在线使用 aet