aent - 云端在线

程序：

您的姓名

aegis 新测试 - 在变更中添加新测试

概要

庇护 -新测试 [ 选项...][ 文件名...]
庇护 -新测试 -列表 [ 选项...]
庇护 -新测试 -帮助

商品描述

- 庇护 -新测试 命令用于向更改添加新测试。 创建一个新文件
在开发目录中。

除非另有说明，新测试默认为“自动”。

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

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

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

测试 文件名 信号生成
您可以通过在命令行上指定来选择自己的文件名进行测试。

如果在命令行上未指定文件名，则自动使用测试文件名
生成的。 这是由 新测试文件名 项目领域
配置文件（见 配置文件(5) 了解更多信息。 全部自动生成
项目中的测试文件名是唯一编号的。 新测试的默认模式
文件名是“测试/XX/tXXXX[am].sh“，在哪里 XX 是测试号码的前 2 位数字，
XXXX 是整个测试数，并且 [是] a 表示自动测试，m 表示手动测试。

修改 检测
将来可能会通过将测试添加到更改中来修改测试 欧共体(1) 命令。
测试的处理方式与任何其他源文件一样，并且遵循相同的过程。

文件 模板
在开发目录中创建新文件时 配置 文件是
搜索新文件的模板。 如果找到模板，新文件将是
初始化为模板，否则将创建为空。 看 配置文件(5) 更多
信息。

最简单的形式就是使用模板文件，比如
文件模板 =
[
{
模式 = [“*.c”];
body = "${read_file ${source template/c abs}}";
},
{
模式= [“测试/*/.sh”];
body = "${read_file ${source template/test abs}}";
},
];
如您所见，模板文件是项目源的一部分，因此您可以添加
适当的版权声明和包装， 等。。 该 $源 替换定位它们，
如果它们不是当前更改的一部分（通常不是）。

模板文件本身包含替换。 这 $文件名 替代是
可用，并包含正在创建的文件的名称。 这可以在
构建适当的文件内容时的各种方法。 看 亚瑟(5) 更多
有关替换的信息。

也可以运行命令来创建新文件。 你可以这样做而不是
指定正文字符串， 即：
文件模板 =
[
{
模式 = [ "*" ];
body_command = "perl ${source template.pl abs} $filename";
},
];
该命令运行时将当前目录设置为开发目录的顶部。
如果该命令无法创建文件，则会出现错误。 您可以将两者混合搭配
技术， 身体 字符串和 身体命令， 如果你想。

请小心确保测试文件名模板模式与
新测试文件名 领域。

文件 姓名 限制
有许多控件可用于限制项目文件名的形式。 所有的
这些控件可以在项目配置文件中找到，请参见 配置文件(5) 更多
信息。 最重要的在这里简要描述：

最大文件名长度 = 整数；
此字段用于限制文件名的长度。 所有新文件可能没有
路径组件比这更长。 如果未设置，则默认为 255。 最大
可移植性，您应该将其设置为 14。

posix_filename_charset = 布尔值；
此字段可用于将文件名中允许的字符限制为仅那些
POSIX 明确允许。 默认为 false 如果未设置，则意味着无论您
操作系统将容忍，除了空格和高位字符。
为了获得最大的便携性，您应该将其设置为 true.

dos_filename_required = 布尔值；
此字段可用于限制文件名，使其符合 DOS 8+3
文件名限制和 DOS 文件名字符集。 默认为 false 如果不
设置。

windows_filename_required = 布尔值；
此字段可用于限制文件名，使其符合 Windows98
和 WindowsNT 文件名限制和字符集。 默认为 false 如果没有设置。

shell_safe_filenames = 布尔值；
此字段可用于限制文件名，使其不包含 shell
特殊的角色。 默认为 true 如果没有设置。 如果此字段设置为 false,
您将需要使用 ${报价} 在命令中替换文件名，以
确保包含 shell 特殊字符的文件名没有意外
副作用。 文件名中的奇怪字符也可能会混淆您的依赖项
维护工具。

allow_white_space_in_filenames = 布尔值；
此字段可用于允许文件名中包含空格字符。 这会
允许以下字符出现在文件名中：退格（BS，\b，0x08），
水平制表符 (HT, \t, 0x09), 换行符 (NL, \n, 0x0A), 垂直制表符 (VT, \v,
0x0B)、换页（FF、\f、0x0C）和回车（CR、\r、0x0D）。 默认为
如果未设置，则为 false。

请注意，此字段不会覆盖其他文件名过滤器。 这将是
需要明确设置 shell_safe_文件名 = false 以及。 这将是
必须设置 dos_文件名_必需 = false （默认）也是如此。 这将是
必须设置 posix_文件名_字符集 = false （默认）也是如此。

用户必须非常小心地在所有文件周围使用 ${quote} 替换
项目配置中命令中的名称。 即便如此，换人
期望以空格分隔的文件名列表将具有未定义的结果。

allow_non_ascii_filenames = 布尔值；
此字段可用于允许文件名中包含非 ascii 可打印字符
他们。 通常这意味着某种 UTF8 或国际字符集。
如果未设置，则默认为 false。

请注意，此字段不会覆盖其他文件名过滤器。 这将是
需要明确设置 shell_safe_文件名 = false 以及。 这将是
必须设置 dos_文件名_必需 = false （默认）也是如此。 这将是
必须设置 posix_文件名_字符集 = false （默认）也是如此。

filename_pattern_accept = [字符串];
此字段用于指定可接受文件名的模式列表。
如果未设置，则默认为“*”。

filename_pattern_reject = [字符串];
此字段用于指定不可接受的文件名模式列表。

请 请注意： Aegis 还咨询底层文件系统，以确定其概念
最大文件大小。 文件系统的最大文件大小小于
最大文件名长度，文件系统获胜。 这可能会发生，例如，当您
使用 Linux UMSDOS 文件系统，或者当你安装了一个 NFS 时，一个古老的 V7
文件系统。 环境 最大文件名长度 在这些情况下到 255 不会改变
事实上，底层文件系统的限制要小得多（分别为 12 和 14）。

如果您的开发目录（或您的整个项目）位于具有 filename 的文件系统上
限制，或者部分异构构建发生在这样的环境中，
它有助于告诉 Aegis 它们是什么（使用项目 配置 文件的字段），以便您
不要遇到项目建立在更宽容的基础上的情况
环境，但在更有限的环境中失败并出现神秘错误。

如果您的开发目录通常位于 Linux UMSDOS 文件系统上，您将
可能更好设置 dos_文件名_必需 = true，并且还改变了
开发目录模板 场地。 各种Windows的异构开发
环境也可能需要这样做。

改变 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 类型 of a 文件
如果你想改变一个文件的类型（比如，从一个测试到一个源文件，或者 副
反之亦然) 你可以把它作为两个变化来做，首先使用 艾尔姆(1) 一改再改
运用 恩夫（1）或 对象(1) 在第二次更改中，或者您可以将两个步骤合并在同一个
改变。 记得使用 艾尔姆 -现在不白了 选项，否则你会得到一个最奇特的新
文件模板。

通知
- 新测试命令 在项目中 配置 文件运行，如果设置。 这 项目文件命令
也会运行，如果设置了，并且最近有集成。 看 配置文件（5）
更多信息。

测试 疗程开始前

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

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

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

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

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

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

测试 相关性

“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 中时，这通常很有用
脚本。

输出 文件名
此选项可用于指定要写入的文件名
自动确定测试文件名。 对于编写脚本很有用。

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

-模板
此选项可用于指定应使用新文件模板，即使
如果文件已经存在。

-No_TEMplate
此选项可用于指定不应使用新文件模板，
即使文件不存在（将创建任何空文件）。

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

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

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

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

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

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

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

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

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

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

推荐 别名

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

错误

如果更改不在 作为 发达 州。
如果未将更改分配给当前用户，则会出现错误。

退出 状态

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

环境 变数

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

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