Українська
Тестові проєкти
Крок 1. Чому справжня база даних
Навіщо. Тести рівня даних часто пишуть на провайдері EF Core «в пам’яті» або на SQLite, бо їм не потрібен сервер. Для Chatex обидва були б марними, адже більшість того, що ми хочемо довести, відбувається всередині PostgreSQL:
- унікальний індекс на
direct_keyі обмеження перевіркиck_chats_direct_key; ILIKE … ESCAPE, можливість PostgreSQL;- порівняння кортежів значень у курсорі списку чатів і
ROW_NUMBER()у його проєкції; ExecuteUpdateAsyncуMarkReadAsync, що не повинен посувати позицію прочитаного назад;- транзакції з відкатом.
Провайдер «в пам’яті» не має обмежень і взагалі не має SQL; SQLite має інший SQL. Тест, що проходить там, нічого не каже про робочу систему. Тому тести виконуються на тому самому PostgreSQL 18, що й розробка та робоча система, у контейнері Docker, який кожен запуск тестів стартує й викидає, – у наступному розділі. Для тестів Docker має працювати.
Chatex використовує для тестування три бібліотеки:
- xUnit v3 – тестовий каркас: тестові класи, методи
[Fact]і[Theory], фікстури, виконавець тестів; - Shouldly – зрозумілі твердження:
count.ShouldBe(3)замістьAssert.Equal(3, count)і повідомлення про помилку, що цитує вираз, який не пройшов; - Testcontainers і Respawn – контейнер бази даних на запуск і швидке скидання між тестами.
Крок 2. Створіть проєкти
Навіщо. Тести живуть у папці Tests/, поруч із Source/. Зараз потрібні два проєкти:
Chatex.Testing– звичайна бібліотека з інфраструктурою: контейнер бази даних і базовий клас тестів бази даних. Бізнес-тести й тести API з наступних тем теж її використовують.Chatex.Data.Tests– тести рівня даних. Кожен рівень отримує власний тестовий проєкт (Chatex.Core.Testsу темі 7,Chatex.Api.Testsу темі 12).
Що зробити.
powershell
dotnet new classlib -o Tests/Chatex.Testingpowershell
dotnet new classlib -o Tests/Chatex.Data.Testspowershell
Remove-Item Tests/Chatex.Testing/Class1.cs, Tests/Chatex.Data.Tests/Class1.cspowershell
dotnet sln add Tests/Chatex.Testing Tests/Chatex.Data.TestsОбидва проєкти тестують або підтримують рівень даних, тож посилаються на нього:
powershell
dotnet add Tests/Chatex.Testing reference Source/Chatex.Datapowershell
dotnet add Tests/Chatex.Data.Tests reference Source/Chatex.DataБібліотеці інфраструктури потрібні три пакети:
powershell
dotnet add Tests/Chatex.Testing package Testcontainers.PostgreSqlpowershell
dotnet add Tests/Chatex.Testing package Respawnpowershell
dotnet add Tests/Chatex.Testing package xunit.v3.extensibility.corexunit.v3.extensibility.core дає бібліотеці інтерфейси xUnit (IAsyncLifetime, TestContext), не роблячи її тестовим проєктом. Як і в темі 2, приберіть <PropertyGroup>, який шаблон записав в обидва файли .csproj; тоді проєкти виглядають так:
xml
<Project Sdk="Microsoft.NET.Sdk">
<ItemGroup>
<ProjectReference Include="..\..\Source\Chatex.Data\Chatex.Data.csproj" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="Respawn" />
<PackageReference Include="Testcontainers.PostgreSql" />
<PackageReference Include="xunit.v3.extensibility.core" />
</ItemGroup>
</Project>xml
<Project Sdk="Microsoft.NET.Sdk">
<ItemGroup>
<ProjectReference Include="..\..\Source\Chatex.Data\Chatex.Data.csproj" />
</ItemGroup>
</Project>Тестовий проєкт перелічує лише те, що тестує. Усе інше, що потрібно тестовому проєкту, походить з одного спільного файлу.
Крок 3. Налаштування для кожного тестового проєкту
Навіщо. Кожному тестовому проєкту потрібне те саме: бути виконуваним файлом (тестові проєкти xUnit v3 – це програми), пакети xUnit, Shouldly і тестового SDK, бібліотека інфраструктури, ті самі глобальні директиви using. Файл Directory.Build.props у папці Tests/ дає їх кожному проєкту нижче.
Є один підступ. MSBuild імпортує лише найближчий Directory.Build.props над проєктом. Файл у Tests/ приховав би той, що в корені репозиторію, зі суворими налаштуваннями з теми 2, – якщо він сам не імпортує цей файл, що й робить його перший рядок.
Що зробити. Створіть Tests/Directory.Build.props:
xml
<Project>
<Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
<!-- Settings shared by the test projects (*.Tests); Chatex.Testing is a plain library. -->
<PropertyGroup Condition="$(MSBuildProjectName.EndsWith('.Tests'))">
<OutputType>Exe</OutputType>
</PropertyGroup>
<PropertyGroup>
<IsPackable>false</IsPackable>
</PropertyGroup>
<ItemGroup Condition="$(MSBuildProjectName.EndsWith('.Tests'))">
<!-- One database per test assembly, so tests in an assembly must not run in parallel. -->
<Content Include="$(MSBuildThisFileDirectory)xunit.runner.json" Link="xunit.runner.json" CopyToOutputDirectory="PreserveNewest" />
<Using Include="Shouldly" />
<Using Include="Xunit" />
<Using Include="Chatex.Testing" />
<ProjectReference Include="$(MSBuildThisFileDirectory)Chatex.Testing/Chatex.Testing.csproj" />
<PackageReference Include="Microsoft.NET.Test.Sdk" />
<PackageReference Include="Shouldly" />
<PackageReference Include="xunit.runner.visualstudio">
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
</PackageReference>
<PackageReference Include="xunit.v3" />
</ItemGroup>
</Project>GetPathOfFileAboveзнаходить наступнийDirectory.Build.propsнад папкоюTests– той, що в корені, – і імпортує його. Усі тестові проєкти зберігають попередження як помилки, nullable та аналізатори.- Умова
$(MSBuildProjectName.EndsWith('.Tests'))застосовує тестові налаштування лише до проєктів, імена яких закінчуються на.Tests.Chatex.Testingлишається звичайною бібліотекою; тестовий проєкт визначає іменування. OutputTypeExe– xUnit v3 збирає кожен тестовий проєкт у програму, що сама виконує свої тести. Разом із налаштуванням"test": { "runner": "Microsoft.Testing.Platform" }уglobal.jsonз теми 2dotnet testзапускає ці програми на новій Microsoft Testing Platform.<Using Include="..." />додає глобальні директивиusing: кожен тестовий файл може використовуватиShould…,[Fact]та інфраструктуру без рядківusing.- Посилання на проєкт
Chatex.Testingі чотири пакети додаються до кожного тестового проєкту.
Поруч створіть налаштування виконавця, які файл props копіює в кожен тестовий проєкт:
json
{
"$schema": "https://xunit.net/schema/current/xunit.runner.schema.json",
"parallelizeTestCollections": false
}Типово xUnit виконує тестові класи паралельно. Усі тести проєкту спільно використовують одну базу даних, яку очищають перед кожним тестом, тож два тести, що виконуються одночасно, стирали б дані один одного. Вимкнення паралельних колекцій змушує тести одного проєкту виконуватися один за одним; різні тестові проєкти й далі виконуються паралельно, кожен із власним контейнером бази даних.
Chatex.slnx тепер має папку /Tests/ з обома проєктами. Збірка на цьому етапі завершується помилкою, і ця помилка повчальна:
error CS0234: The type or namespace name 'Testing' does not exist in the namespace 'Chatex'Глобальний using Chatex.Testing посилається на простір імен, що ще не має типів, – порожня бібліотека не визначає просторів імен. Наступний розділ заповнює її, і збірка знову успішна.