1[/ 2 / Copyright (c) 2019 Raffi Enficiaud 3 / 4 / Distributed under the Boost Software License, Version 1.0. (See accompanying 5 / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) 6 /] 7 8[section:test_tree Test tree] 9 10The test tree is the hierarchy of test cases and test suites, along with all the fixtures (global, case or 11suite level), and the respective dependencies within all those elements. 12 13A test tree is composed with: 14 15* Test cases: those are the elements in the tree that contain the body of the tests, and they constitute 16 the [*leaves] of the tree. 17* Test suites: those are the are internal nodes of the tree. These elements that do not have any body or executable code themselves, 18 but fixtures that execute code and tests can be attached to them. 19* The master test suite: this is the root of the tree, and is by definition a test suite. Fixtures attached to the master test suite 20 are [*global] fixtures. 21* fixtures: those are units of code that are executed before and/or after the test units above. 22 23The following hierarchy represents a test tree (further detailed in the [link boost_test.tests_organization.test_tree.test_suite test-suite] 24section) [*without] any fixture: 25 26[$images/class-hier.jpg] 27 28[link boost_test.tests_organization.decorators Decoration] can be added to test suites and cases except for the master test suite. Those 29decoration may modify the way the __UTF__ 30handles the tree. For instance, there is no defined order in the execution of test cases enforced by the tree itself, except for the fixtures 31and the elements they relate to (suite, case); decoration may be used to instruct a specific order among the elements of the tree. 32 33[note The test-tree by itself does not give any particular order in the execution of the test-cases. The only implicit order 34 is given by the fixtures. To indicate a particular order, specific decorators should be used.] 35 36[include test_suites.qbk] 37[include master_test_suite.qbk] 38[include test_naming.qbk] 39[include test_tree_content.qbk] 40 41[endsect] [/ test test_tree] 42
