SapphireTest
abstract class SapphireTest extends TestCase implements TestOnly (View source)
Test case class for the Sapphire framework.
Sapphire unit testing is based on PHPUnit, but provides a number of hooks into our data model that make it easier to work with.
This class should not be used anywhere outside of unit tests, as phpunit may not be installed in production sites.
Methods
No description
Gets illegal extensions for this class
Gets required extensions for this class
No description
No description
No description
No description
Called once per test case ({@link SapphireTest} subclass).
tearDown method that's called once per test class rather once per test method.
Clear all fixtures which were previously loaded through {@link loadFixture()}
Asserts that an array has a specified subset.
No description
No description
Clear the log of emails sent
Search for an email that was sent.
Assert that the matching email was sent since the last call to clearEmails() All of the parameters can either be a string, or, if they start with "/", a PREG-compatible regular expression.
Assert that the given {@link SS_List} includes DataObjects matching the given key-value pairs. Each match must correspond to 1 distinct record.
Asserts that no items in a given list appear in the given dataobject list
Assert that the given {@link SS_List} includes only DataObjects matching the given key-value pairs. Each match must correspond to 1 distinct record.
Assert that the every record in the given {@link SS_List} matches the given key-value pairs.
Asserts that two SQL queries are equivalent
Asserts that a SQL query contains a SQL fragment
Asserts that a SQL query contains a SQL fragment
Start test environment
Reset the testing database's schema, but only if it is active
A wrapper for automatically performing callbacks as a user with a specific permission
Create a member and group with the given permission code, and log in with it.
Log out the current user
Return all extra objects to scaffold for this test
Get additional controller classes to register routes for
Details
static TempDatabase
tempDB()
static array
getIllegalExtensions()
Gets illegal extensions for this class
static array
getRequiredExtensions()
Gets required extensions for this class
static string|string[]
get_fixture_file()
bool
getUsesDatabase()
bool
getUsesTransactions()
array
getRequireDefaultRecordsFrom()
static void
setUpBeforeClass()
Called once per test case ({@link SapphireTest} subclass).
This is different to {@link setUp()}, which gets called once per method. Useful to initialize expensive operations which don't change state for any called method inside the test, e.g. dynamically adding an extension. See {@link teardownAfterClass()} for tearing down the state again.
Always sets up in order:
- Reset php state
- Nest
- Custom state helpers
User code should call parent::setUpBeforeClass() before custom setup code
static void
tearDownAfterClass()
tearDown method that's called once per test class rather once per test method.
Always sets up in order:
- Custom state helpers
- Unnest
- Reset php state
User code should call parent::tearDownAfterClass() after custom tear down code
FixtureFactory
getFixtureFactory()
deprecated
deprecated
SapphireTest
setFixtureFactory(FixtureFactory $factory)
deprecated
deprecated
Sets a new fixture factory
void
loadFixture(string $fixtureFile)
deprecated
deprecated
Load a YAML fixture file into the database.
Once loaded, you can use idFromFixture() and objFromFixture() to get items from the fixture. Doesn't clear existing fixtures.
void
clearFixtures()
Clear all fixtures which were previously loaded through {@link loadFixture()}
static void
assertArraySubset(array|ArrayAccess $subset, array|ArrayAccess $array, bool $checkForObjectIdentity = false, string $message = '')
Asserts that an array has a specified subset.
static void
assertContains($needle, $haystack, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false)
static void
assertNotContains($needle, $haystack, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false)
bool
clearEmails()
Clear the log of emails sent
static array
findEmail(string $to, string $from = null, string $subject = null, string $content = null)
Search for an email that was sent.
All of the parameters can either be a string, or, if they start with "/", a PREG-compatible regular expression.
static void
assertEmailSent(string $to, string $from = null, string $subject = null, string $content = null)
Assert that the matching email was sent since the last call to clearEmails() All of the parameters can either be a string, or, if they start with "/", a PREG-compatible regular expression.
static void
assertListContains(SS_List|array $matches, SS_List $list, string $message = '')
Assert that the given {@link SS_List} includes DataObjects matching the given key-value pairs. Each match must correspond to 1 distinct record.
assertDOSContains(array $matches, $dataObjectSet)
deprecated
deprecated
static void
assertListNotContains(SS_List|array $matches, SS_List $list, string $message = '')
Asserts that no items in a given list appear in the given dataobject list
static
assertNotDOSContains($matches, $dataObjectSet)
deprecated
deprecated
static void
assertListEquals(mixed $matches, SS_List $list, string $message = '')
Assert that the given {@link SS_List} includes only DataObjects matching the given key-value pairs. Each match must correspond to 1 distinct record.
Example
Check that only the entries Sam Minnee and Ingo Schommer exist in $members. Order doesn't matter: $this->assertListEquals([ ['FirstName' =>'Sam', 'Surname' => 'Minnee'], ['FirstName' => 'Ingo', 'Surname' => 'Schommer'], ], $members);
assertDOSEquals($matches, SS_List $dataObjectSet)
deprecated
deprecated
static void
assertListAllMatch(mixed $match, SS_List $list, string $message = '')
Assert that the every record in the given {@link SS_List} matches the given key-value pairs.
Example
Check that every entry in $members has a Status of 'Active': $this->assertListAllMatch(['Status' => 'Active'], $members);
assertDOSAllMatch($match, SS_List $dataObjectSet)
deprecated
deprecated
static void
assertSQLEquals(string $expectedSQL, string $actualSQL, string $message = '', int $delta = 0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false)
Asserts that two SQL queries are equivalent
static void
assertSQLContains(string $needleSQL, string $haystackSQL, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true)
Asserts that a SQL query contains a SQL fragment
static void
assertSQLNotContains(string $needleSQL, string $haystackSQL, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true)
Asserts that a SQL query contains a SQL fragment
static void
start()
Start test environment
static void
resetDBSchema(bool $includeExtraDataObjects = false, bool $forceCreate = false)
Reset the testing database's schema, but only if it is active
mixed
actWithPermission(string|array $permCode, callable $callback)
A wrapper for automatically performing callbacks as a user with a specific permission
int
logInWithPermission(string|array $permCode = 'ADMIN')
Create a member and group with the given permission code, and log in with it.
Returns the member ID.
void
logInAs(Member|int|string $member)
Log in as the given member
void
logOut()
Log out the current user
static array
getExtraDataObjects()
Return all extra objects to scaffold for this test
static array
getExtraControllers()
Get additional controller classes to register routes for