From db8225e624d01291aed59a1cca663a9cb33e9514 Mon Sep 17 00:00:00 2001 From: romanb Date: Sun, 10 Feb 2008 15:51:55 +0000 Subject: [PATCH] changes on the new test suite. --- tests/lib/Doctrine_OrmTestCase.php | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/tests/lib/Doctrine_OrmTestCase.php b/tests/lib/Doctrine_OrmTestCase.php index b623ee31b..1c19eabb1 100644 --- a/tests/lib/Doctrine_OrmTestCase.php +++ b/tests/lib/Doctrine_OrmTestCase.php @@ -27,8 +27,14 @@ class Doctrine_OrmTestCase extends Doctrine_TestCase * from within the setUp() method of testcases. The database will then be * populated with fresh data of all loaded fixtures for each test method. * + * WARNING: A single testcase should never load fixtures from different scenarios of + * the same package as the concistency and uniqueness of keys is not guaranteed. + * * @param string $package The package name. Must be one of Doctrine's test model packages * (forum, cms or ecommerce). + * @param string $scenario The fixture scenario. A model package can have many fixture + * scenarios. Within a scenario all primary keys and foreign keys + * of fixtures are consistent and unique. * @param string $name The name of the fixture to load from the specified package. */ protected function loadFixture($package, $scenario, $name) @@ -69,13 +75,19 @@ class Doctrine_OrmTestCase extends Doctrine_TestCase } /** - * Loads multiple fixtures of the same package. + * Loads multiple fixtures of the same package and scenario. * This method must only be called from within the setUp() method of testcases. * The database will then be populated with fresh data of all loaded fixtures for each * test method. * + * WARNING: A single testcase should never load fixtures from different scenarios of + * the same package as the concistency and uniqueness of keys is not guaranteed. + * * @param string $package The package name. Must be one of Doctrine's test model packages * (forum, cms or ecommerce). + * @param string $scenario The fixture scenario. A model package can have many fixture + * scenarios. Within a scenario all primary keys and foreign keys + * of fixtures are consistent and unique. * @param array $names The names of the fixtures to load from the specified package. */ protected function loadFixtures($package, $scenario, array $names)