Допоміжні класи

DomQuery

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

# створення DomQuery з HTML рядка
$dom = Tester\DomQuery::fromHtml('
	<article class="post">
		<h1>Title</h1>
		<div class="content">Text</div>
	</article>
');

# тест існування елементів за допомогою CSS селекторів
Assert::true($dom->has('article.post'));
Assert::true($dom->has('h1'));

# знаходження елементів як масиву об'єктів DomQuery
$headings = $dom->find('h1');
Assert::same('Title', (string) $headings[0]);

# тест, чи елемент відповідає селектору (з версії 2.5.3)
$content = $dom->find('.content')[0];
Assert::true($content->matches('div'));
Assert::false($content->matches('p'));

# знаходження найближчого предка, що відповідає селектору (з 2.5.5)
$article = $content->closest('.post');
Assert::true($article->matches('article'));

FileMock

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

# Тестований клас
class Logger
{
	public function __construct(
		private string $logFile,
	) {
	}

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

# Новий порожній файл
$file = Tester\FileMock::create('');

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

# Тестуємо створений вміст
Assert::same("Login\nLogout\n", file_get_contents($file));

Assert::with()

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

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

$ent = new Entity;

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

Helpers::purge()

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

@mkdir(__DIR__ . '/tmp');  # @ - директорія вже може існувати

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 вже не final
{
	// ...
}

Environment::setup()

  • покращує читабельність виводу помилок (включно з підсвічуванням), інакше виводиться стандартне PHP трасування стека
  • вмикає перевірку, що в тесті були викликані assertion, інакше тест без assertion (наприклад, забутих) також пройде
  • при використанні --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 "Працюю в потоці номер " . getenv(Tester\Environment::VariableThread);