Помічники

DomQuery

Tester\DomQuery це клас, що розширює SimpleXMLElement з методами, які полегшують тестування вмісту HTML або XML.

# в $html знаходиться рядок з HTML-документом, в $dom ми отримуємо кореневий елемент
$dom = Tester\DomQuery::fromHtml($html);

# we can test the presence of elements using CSS selectors
Assert::true($dom->has('form#registration'));
Assert::true($dom->has('input[name="username"]'));
Assert::true($dom->has('input[type="submit"]'));

# or select elements as array of DomQuery
$elems = $dom->find('input[data-autocomplete]');

# або перевірка відповідності елемента селектору (починаючи з версії 2.5.3)
Assert::true($elems[0]->matches('[type="submit"]'));

FileMock

Tester\FileMock емулює файли в пам'яті, щоб допомогти вам протестувати код, який використовує функції на кшталт fopen(), file_get_contents() або parse_ini_file(). Наприклад:

# Tested class
class Logger
{
	public function __construct(
		private string $logFile,
	) {
	}

	public function log(string $message): void
	{
		file_put_contents($this->logFile, $message . "\n", FILE_APPEND);
	}
}

# New empty file
$file = Tester\FileMock::create('');

$logger = new Logger($file);
$logger->log('Login');
$logger->log('Logout');

# Created content testing
Assert::same("Login\nLogout\n", file_get_contents($file));

Assert::with()

Це не твердження, а помічник для тестування приватних методів і властивостей об'єктів.

class Entity
{
	private $enabled;
	// ...
}

$ent = new Entity;

Assert::with($ent, function () {
	Assert::true($this->enabled); // доступний private $ent->enabled
});

Helpers::purge()

Метод purge() створює вказаний каталог і, якщо він уже існує, видаляє весь його вміст. Він зручний для створення тимчасових каталогів. Наприклад, у tests/bootstrap.php:

@mkdir(__DIR__ . '/tmp');  # @ - directory may already exist

define('TempDir', __DIR__ . '/tmp/' . getmypid());
Tester\Helpers::purge(TempDir);

Environment::lock()

Тести запускаються паралельно. Іноді нам не потрібно перекривати час виконання тестів. Зазвичай тести баз даних потребують підготовки вмісту бази даних, і їм потрібно, щоб ніщо не заважало їм під час виконання тесту. У цих випадках ми використовуємо Tester\Environment::lock($name, $dir):

Tester\Environment::lock('database', __DIR__ . '/tmp');

Перший аргумент – ім'я блокування. Другий – шлях до каталогу для збереження блокування. Спочатку запускається тест, який отримує блокування. Решта тестів повинні почекати, поки він завершиться.

Environment::bypassFinals()

Класи або методи, позначені як final, важко тестувати. Виклик Tester\Environment::bypassFinals() на початку тестування призводить до того, що ключові слова final видаляються під час завантаження коду.

require __DIR__ . '/bootstrap.php';

Tester\Environment::bypassFinals();

class MyClass extends NormallyFinalClass  # <-- NormallyFinalClass is not final anymore
{
	// ...
}

Environment::setup()

  • покращує читабельність дампа помилок (увімкнено розфарбування), інакше виводиться стандартне трасування стека PHP
  • дозволяє перевірити, що твердження були викликані в тесті, інакше тести без (наприклад, забутих) тверджень теж пройдуть
  • автоматично запускає збирач покриття коду під час використання --coverage (описано пізніше)
  • друкує статус OK або FAILURE наприкінці скрипта

Environment::setupFunctions()

Створює глобальні функції test(), testException(), setUp() і tearDown(), на які можна розбити тести.

test('опис тесту', function () {
	Assert::same(123, foo());
	Assert::false(bar());
	// ...
});

Environment::VariableRunner

Позволяет узнать, был ли тест запущен напрямую или через Tester.

if (getenv(Tester\Environment::VariableRunner)) {
	# запускається Tester
} else {
	# інший спосіб
}

Environment::VariableThread

Tester запускает тесты параллельно в заданном количестве потоков. Мы найдем номер потока в переменной окружения, когда нас это заинтересует:

echo "I'm running in a thread number " . getenv(Tester\Environment::VariableThread);