День четыреста пятьдесят восьмой. #ЧтоНовенького
Генераторы Кода C#
В виде превью выпущена новая функция языка C# - Генераторы Кода (Source Generators), которая позволяет разработчикам C# инспектировать пользовательский код и генерировать новые файлы исходного кода C#, которые можно добавлять в компиляцию.

Генератор исходного кода - это фрагмент кода, который выполняется во время компиляции и может проверить вашу программу на предмет наличия дополнительных файлов, которые скомпилируются вместе с остальным кодом.

Генератор кода позволяет делать две основные вещи:
1. Получить объект компиляции, представляющий собой весь пользовательский код, предназначенный для компиляции. Этот объект может быть инспектирован: можно написать код, который работает с синтаксической и семантической моделями компилируемого кода так же, как современные анализаторы кода.
2. Создавать файлы исходного кода C#, которые можно добавить к объекту компиляции прямо в процессе компиляции. То есть вы можете предоставить дополнительный исходный код в качестве входных данных для компиляции, пока код компилируется.

Таким образом, вы можете инспектировать пользовательский код со всеми расширенными метаданными, которые компилятор создаёт во время компиляции, а затем отправлять код обратно в ту же компиляцию на основании данных анализа.

Генераторы исходного кода работают как дополнительная фаза компиляции (см. картинку ниже).

Примеры Использования
1. ASP.NET Core использует отражение при первом запуске веб-службы для обнаружения определённых вами конструкций, чтобы они могли «связывать» контроллеры с представлениями. Хотя это позволяет писать простой код, используя мощные абстракции, это сопровождается снижением производительности во время выполнения: при первом запуске веб-службы или приложения оно не может принимать запросы до тех пор, пока не завершится анализ вашего кода через отражение. Хотя это снижение производительности не является огромным, это определённая фиксированная плата, которой вы не можете избежать. При использовании генератора кода фаза обнаружения контроллера может происходить во время компиляции, что ускорит запуск приложения.

2. Некоторые сценарии включают вызов MSBuild несколько раз, чтобы проверять данные из компиляции. Можно использовать генераторы исходного кода, чтобы устранить необходимость в этом, поскольку генераторы исходного кода не просто дают преимущества в производительности, но также позволяют инструментам работать на должном уровне абстракции.

3. Устранение использования некоторых «строковых» API, например, маршрутизации в ASP.NET Core между контроллерами и представлениями. При использовании генератора кода маршрутизация может быть строго типизирована, а необходимые строки могут генерироваться во время компиляции.

По мере доработки генераторов кода в Microsoft ожидают, что появятся новые сценарии использования.

Как упоминалось ранее, пока генераторы кода выпущены в превью, чтобы позволить авторам библиотек опробовать эту функцию и дать обратную связь. По ходу доработок могут произойти изменения в API и характеристиках. Релиз намечен вместе с выходом C# 9.

Чтобы попробовать генераторы кода, нужно установить превью .NET 5 и последнюю превью версию Visual Studio.

Источник: https://devblogs.microsoft.com/dotnet/introducing-c-source-generators/