Reo.Core.TestCaseCollector.CodeGeneration 8.0.517

Reo.Core.TestCaseCollector.CodeGeneration

Описание пакета

Пакет Reo.Core.TestCaseCollector.CodeGeneration предназначен для автоматической генерации кода тестов и упрощения работы с синтаксическими деревьями в проектах, использующих C# и Roslyn. Он решает проблему ручного написания повторяющихся тестовых сценариев и позволяет автоматически создавать тесты на основе атрибутов или аннотаций в коде. Пакет также предоставляет инструменты для анализа и манипуляции с кодом, что ускоряет разработку и повышает точность тестирования.

Основные компоненты

1. RoslynExtensions

Класс, предоставляющий расширения для работы с Roslyn, включая:

• Поиск синтаксических узлов (например, методов, классов) в дереве кода.
• Получение информации об атрибутах и модификаторах.
• Анализ документации (XML-комментариев) для синтаксических элементов.

2. DI-регистрация (Dependency Injection)

Механизм автоматической регистрации служб и генераторов тестов в контейнере DI (например, в ASP.NET Core). Позволяет интегрировать генерацию тестов в приложения с минимальными усилиями.

3. Атрибуты для аннотирования кода

Атрибуты, которые можно использовать в исходном коде, чтобы указать, какие методы или классы требуют автоматической генерации тестов. Например, [GenerateTests] может быть применён к методам, чтобы сгенерировать соответствующие тесты.

4. Конфигурационные параметры

Настройки, которые позволяют контролировать поведение генерации тестов, например:

• Игнорирование определённых методов.
• Указание шаблонов для тестовых классов.

Требования

• .NET Standard 2.0 (совместимость с .NET Framework, .NET Core и .NET 5+).
• Roslyn SDK (для работы с синтаксическими деревьями).
• ASP.NET Core (для интеграции с DI-контейнером).

Установка

Используйте следующие команды для установки пакета через NuGet:

# NuGet Package Manager
Install-Package Reo.Core.TestCaseCollector.CodeGeneration

# .NET CLI
dotnet add package Reo.Core.TestCaseCollector.CodeGeneration

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

Добавьте службу в ConfigureServices вашего Startup.cs или Program.cs:

services.AddTestCaseGeneration();

Конфигурационные параметры

Настройки можно указать в appsettings.json:

{
  "TestCaseGeneration": {
    "IgnoreMethods": ["TestMethod1", "TestMethod2"],
    "TestTemplate": "GeneratedTests_{ClassName}"
  }
}

Использование

Пример 1: Аннотирование метода для генерации теста

[GenerateTests]
public void MyMethod()
{
    // Логика метода
}

После сборки проекта будет сгенерирован тестовый класс GeneratedTests_MyMethod.

Пример 2: Поиск методов с атрибутом [GenerateTests] через Roslyn

var methods = compilation.GetSyntaxTrees()
    .SelectMany(tree => tree.GetRoot().DescendantNodes())
    .OfType<MethodDeclarationSyntax>()
    .Where(method => method.AttributeLists
        .Any(attr => attr.Attributes.Any(a => a.Name.ToString() == "GenerateTests")));

Пример 3: Интеграция с ASP.NET Core

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddTestCaseGeneration(); // Регистрация генератора тестов
}

Лицензия

Этот пакет распространяется под лицензией MIT. Детали лицензии можно найти в файле LICENSE.