From b92ea63417bc6933393a3c285faf393b3d287ac2 Mon Sep 17 00:00:00 2001 From: Erlang/OTP Date: Mon, 12 Dec 2011 18:14:34 +0100 Subject: Prepare release --- lib/common_test/doc/src/notes.xml | 157 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 157 insertions(+) (limited to 'lib/common_test/doc') diff --git a/lib/common_test/doc/src/notes.xml b/lib/common_test/doc/src/notes.xml index af96ef621f..da0b6b2d65 100644 --- a/lib/common_test/doc/src/notes.xml +++ b/lib/common_test/doc/src/notes.xml @@ -32,6 +32,163 @@ notes.xml +
Common_Test 1.6 + +
Improvements and New Features + + +

+ A Getting Started chapter has been added to the Common + Test User's Guide.

+

+ Own Id: OTP-9156

+ + +

+ The test case group info function has been implemented in + Common Test. Before execution of a test case group, a + call is now made to TestSuite:group(GroupName). + The function returns a list of test properties, e.g. to + specify timetrap values, require configuration data, etc + (analogue to the test suite- and test case info + function). The scope of the properties set by + group(GroupName) is all test cases and sub-groups + of group GroupName.

+

+ Own Id: OTP-9235

+ + +

+ Common Test hooks are now in a final supported version. + The Common Test hooks allow you to abstract out + initialization behaviour that is common to multiple test + suites into one place and also extend the behaviour of a + suite without changing the suite itself. For more + information see the Common Test user's guide.

+

+ Own Id: OTP-9449

+ + +

+ A new built-in common test hook has been added which + captures error_logger and SASL event and prints them in + the testcase log. To disable this (and any other built-in + hooks) pass 'enable_builtin_hooks false' to common test.

+

+ Own Id: OTP-9543

+ + +

+ Common Test now calls info functions also for the + init/end_per_suite/1 and + init/end_per_group/2 configuration functions. + These can be used e.g. to set timetraps and require + external configuration data relevant only for the + configuration functions in question (without affecting + properties set for groups and test cases in the suite). + The info function for init/end_per_suite(Config) + is init/end_per_suite(), and for + init/end_per_group(GroupName,Config) it's + init/end_per_group(GroupName). Info functions can + not be used with init/end_per_testcase(TestCase, + Config), since these configuration functions execute + on the test case process and will use the same properties + as the test case (i.e. properties set by the test case + info function, TestCase()).

+

+ Own Id: OTP-9569

+ + +

+ It's now possible to read the full name of the test case + log file during execution. One way to do this is to + lookup it up as value of the key tc_logfile in the + test case Config list (which means it can also be + read by a pre- or post Common Test hook function). The + data is also sent with the event + #event{name=tc_logfile,data={{Suite,Func},LogFileName}}, + and can be read by any installed event handler.

+

+ Own Id: OTP-9676 Aux Id: seq11941

+ + +

+ The look of the HTML log files generated by Common Test + and Test Server has been improved (and made easier to + customize) by means of a CSS file.

+

+ Own Id: OTP-9706

+ + +

+ Functions ct:fail(Format, Args) and ct:comment(Format, + Args) have been added in order to make printouts of + formatted error and comment strings easier (no need for + the user to call io_lib:format/2 explicitly).

+

+ Own Id: OTP-9709 Aux Id: seq11951

+ + +

+ The order in which ct hooks are executed for cleanup + hooks (i.e. *_end_per_* hooks) has been reversed.

+

+ *** POTENTIAL INCOMPATIBILITY ***

+

+ Own Id: OTP-9774 Aux Id: seq11913

+ + +

+ Printouts to stdout may be captured during test case + execution. This is useful in order to e.g. read and parse + tty printouts from the SUT during test case execution (if + necessary, say, to determine the outcome of the test). + The capturing session is started with + ct:capture_start/0, and stopped with + ct:capture_stop/0. The list of buffered strings is + read and purged with ct:capture_get/0/1. It's + possible to filter out printouts made with + ct:log/2/3 and ct:pal/2/3 from the captured + list of strings. This is done by calling + capture_get/1 with a list of log categories to + exclude.

+

+ Own Id: OTP-9775

+ + +

+ The syntax for specifying test case groups in the all/0 + list has been extended to include execution properties + for both groups and sub-groups. The properties specified + in all/0 for a group overrides the properties specified + in the group declaration (in groups/0). The main purpose + of this extension is to make it possible to run the same + set of tests, but with different properties, without + having to declare copies of the group in question. Also, + the same syntax may be used in test specifications in + order to change properties of groups at the time of + execution, without having to edit the test suite. Please + see the User's Guide for details and examples.

+

+ Own Id: OTP-9809 Aux Id: OTP-9235

+ + +
+ + +
Known Bugs and Problems + + +

+ Fix problems in CT/TS due to line numbers in exceptions.

+

+ Own Id: OTP-9203

+ + +
+ +
+
Common_Test 1.5.5
Fixed Bugs and Malfunctions -- cgit v1.2.3