给一个有状态的函数做单元测试,常会碰到这样的安排:每个用例开始时清零计数器,同一用例里连续调用两次函数,观察计数能不能累加。清零代码如果写在每个步骤的开头,两次调用就接不上了。TESSY可以在测试对象、测试用例和测试步骤三个层级添加用户代码。把代码放在哪一层,决定了它何时执行、会影响哪些结果。以下以TESSY 5.1的单元测试为例。
一、TESSY用户代码怎么添加
用于测试前准备和测试后处理的C代码,可以在测试数据编辑视图中添加。TESSY会将这些代码编入测试驱动,测试时在指定位置执行。
1、在测试数据编辑器中选中对应层级
假设被测函数用全局变量保存累计值。希望每个用例从零开始,同时保留同一用例内各步骤之间的状态,就把清零代码写在用例层。
①打开测试对象的【TDE】,在【Test Items】中选中要编辑的测试用例。
②切换到【Prolog/Epilog】视图,核对当前显示的是【Test Case】,避免误选下方的测试步骤。
③在【Prolog】区域写入初始化代码。例如,被测函数使用的累计变量为total,可在该变量能被测试驱动访问时写入【total=0;】。
④保存测试数据,执行选中的用例,在【TDE】中查看实际结果。
2、为多个步骤设置共用代码
①若同一用例下的多个步骤都需要同一段准备代码,在【Test Items】选中该用例,再到【Prolog/Epilog】中打开【Default for Test Steps】。
②若要给同一测试对象下的用例提供共用代码,选中测试对象,在【Default for Test Cases】中填写。
③选中具体用例或步骤,在【Prolog/Epilog】查看当前代码来自默认设置还是本级设置。需要查找已定义的位置时,可打开【Usercode Outline】。
默认代码会在继承它的用例或步骤对应的时点执行。某个步骤单独改写了前置代码时,还可能继续沿用默认的后置代码。检查时可以分别看上下两个编辑区,别只看其中一处就认定整套代码都来自同一个层级。
二、TESSY用户代码按什么顺序执行
正常执行且每步调用一次时,先运行测试对象的前置代码,再进入当前用例的前置代码。进入某个测试步骤后,TESSY先赋入该步测试数据,再执行步骤前置代码、调用被测函数、执行步骤后置代码,最后采集该步实际值。一个用例的步骤走完后执行该用例的后置代码,随后处理下一个用例。选定用例全部执行完,才运行测试对象的后置代码。
1、用两步调用检查前置代码的位置
①在【Test Case】的【Prolog】中清零累计变量,为同一用例建立两个【Test Step】。
②若被测函数的行为是把本次输入加到累计值上,在【TDE】给两步分别填入2和3,将对应的累计期望值填为2和5。
③确认【Repeat Count】为1,执行用例,检查第二步的实际累计值。
若第二步读到的是3,可以先查步骤前置代码及其继承设置,看是否在第二次调用前又做了清零。还要检查累计变量是否被配置为输入,并在第二步重新赋值。代码写对了层级,测试数据仍可能把上一步留下的状态覆盖掉。
2、检查步骤代码会不会改写输入和结果
步骤前置代码在测试数据赋值后运行,步骤后置代码则在实际值采集前运行。只要写到了同一个变量,先后顺序就会反映在测试结果里。
①对照【TDE】中的步骤输入,检查【Prolog】是否再次给同一输入变量赋值。若是有意构造输入,在用例说明中注明函数实际收到的值。
②检查【Epilog】是否清零或改写了准备比较的输出变量。需要保留函数调用结果时,将这类清理放到合适的用例收尾位置。
③重新执行用例,对照【期望值】和【实际值】,确认报告中的数值对应想要验证的状态。
3、把桩函数放回调用链里看
①在【Stub Functions】中核对被测函数依赖的外部调用,确认桩代码适用的测试对象、用例或步骤。
②在【TDE】分别准备会走到该调用和不会走到该调用的两组输入。
③执行两组数据,结合【Stub Functions】中的设置和调试记录,检查被测函数走到相应分支时是否调用了桩。桩代码的执行取决于调用路径。
三、TESSY用户代码执行结果不符怎么查
有时候报告里的值差了一截,单看那段C代码还找不出原因。先看这段代码实际被放进了测试驱动的哪个位置,再看该步骤的调用次数,会更容易定位。
1、确认本次测试用的是哪段代码
①在【Usercode Outline】中展开当前测试对象,找到出问题的用例和步骤。
②打开【Prolog/Epilog】,分别核对前置、后置代码的来源,检查本级代码是否覆盖了原有默认设置。
③保存修改并重新执行。在可调试的环境中,可在【测试驱动】的输入赋值、函数调用和结果采集处查看变量,找出它在哪一处发生变化。
同一段初始化代码可能在默认设置里,也可能在某个步骤里被改写过。按报告中的用例号和步骤号回查,比在整个工程里搜索变量名更容易找到当次生效的代码。
2、核对一个步骤内是否重复调用
当计数变化比预期多时,也要看看同一步骤是否调用了被测函数多次。这个设置常用于连续调用测试,漏看它就容易把累计结果误判成函数错误。
①选中该【Test Step】,查看【Repeat Count】。
②检查前置用户代码是否给【TS_REPEAT_COUNT】赋值,并核对当前步骤继承的前置代码。
③在用例副本中将重复次数设为一次,移除影响该次数的赋值,再比较【实际值】与原测试结果。
总结
写用户代码时,可以先想清楚哪些状态要在用例之间重置,哪些状态要留给下一步接着用。像累计计数、状态机或连续读写这类测试,两个步骤往往比一个步骤更容易暴露初始化位置的问题。报告里若出现意料之外的数值,也值得沿着输入赋值、函数调用和结果采集看一遍,确认被比较的正是你想观察的那一刻。