День 2291. #TipsAndTricks
Скрипт PowerShell для Переименования Проектов .NET
Переименовать проект .NET — утомительное занятие. Вам придётся переименовать файлы и папки, а также заменить содержимое в файлах, например пространство имён или путь в файлах .sln.

Следующий скрипт PowerShell, переименует файлы и папки и заменит содержимое в файлах:

$ErrorActionPreference = "Stop"

$rootFolder = Resolve-Path -Path "."
$oldName = "SampleRazorPages"
$newName = "SampleWebApp"

# Переименовываем файлы и папки
foreach ($item in Get-ChildItem -LiteralPath $rootFolder -Recurse | Sort-Object -Property FullName -Descending) {
  $itemNewName = $item.Name.Replace($oldName, $newName)
  if ($item.Name -ne $itemNewName) {
    Rename-Item -LiteralPath $item.FullName -NewName $itemNewName
  }
}

# Заменяем содержимое в файлах
foreach ($item in Get-ChildItem $rootFolder -Recurse -Include "*.cmd", "*.cs", "*.csproj", "*.json", "*.md", "*.proj", "*.props", "*.ps1", "*.sln", "*.slnx", "*.targets", "*.txt", "*.vb", "*.vbproj", "*.xaml", "*.xml", "*.xproj", "*.yml", "*.yaml") {
  $content = Get-Content -LiteralPath $item.FullName
  if ($content) {
    $newContent = $content.Replace($oldName, $newName)
    Set-Content -LiteralPath $item.FullName -Value $newContent
  }
}

Источник: https://www.meziantou.net/powershell-script-to-rename-dotnet-projects.htm

День 2298. #TipsAndTricks
Очистка Кэшей NuGet
NuGet может кэшировать множество пакетов и других вещей с течением времени. Сегодня рассмотрим, как очистить большинство из этого.

Вы можете посмотреть используемые кэши и их местонахождения, выполнив следующую команду:

dotnet nuget locals all --list

Вывод будет примерно таким:

http-cache: C:\Users\sbenz\AppData\Local\NuGet\v3-cache
global-packages: C:\Users\sbenz\.nuget\packages\
temp: C:\Users\sbenz\AppData\Local\Temp\NuGetScratch
plugins-cache: C:\Users\sbenz\AppData\Local\NuGet\plugins-cache

Со временем там накапливается гигантский объём данных. У меня http-cache больше 2ГБ, а global-packages больше 20ГБ. Если у вас достаточно места, можете оставить всё как есть. Это просто кэшированные данные, которые на самом деле безвредны (кроме занятого места).

Кэш NuGet-пакетов
Папка global-packages — это то место, куда dotnet restore помещает все пакеты пользователя. Поэтому неважно, в каком репозитории вы находитесь, он всегда загружает каждый пакет (конечно, включая все зависимости, которые требуются пакету) в эту папку. Преимущество в том, что, если только это не nodejs и npm, у вас будет супербыстрое восстановление для пакетов, которые уже загружены и не являются локальными для вашего репозитория.

Чтобы удалить кэш (что приведёт к повторной загрузке требуемых пакетов), вы можете либо очистить содержимое папки, либо просто вызвать:

dotnet nuget locals global-packages --clear

Кэш Http
То же самое относится к http-cache. По сути, он хранит метаданные в пакетов (например, в каких версиях они существуют в NuGet), но также, похоже, содержит некоторые бинарные файлы. В любом случае, если вы хотите удалить это:

dotnet nuget locals http-cache --clear

Временные данные
Папка temp хранит временные файлы. Очистить её можно так:

dotnet nuget locals temp --clear

Удалить всё
Следующая команда удалит все кэшированные данные NuGet:

dotnet nuget locals all --clear

После этого, при создании нового приложения, все данные NuGet будут скачаны заново из интернета. Но это также уберёт всё ненужное!

Источник: https://steven-giesel.com/blogPost/ef7e9271-3b8d-4658-988f-b48bbd11e320/clearing-nuget-caches

День 2302. #ЧтоНовенького #TipsAndTricks
Используем Расширения C# 14 для Парсинга Enum
Расширения ещё только в планах для C# 14, а умельцы уже предлагают интересные варианты их использования.

В .NET многие типы предоставляют статический метод Parse для преобразования строк в соответствующие им типы. Например:

int.Parse("123");
double.Parse("123.45");
DateTime.Parse("2023-01-01");
IPAddress.Parse("192.168.0.1");

В перечислениях используется обобщённый метод Enum.Parse:

Enum.Parse<MyEnum>("Value1");

А вот это не сработает:

MyEnum.Parse("Value1");

Было бы более интуитивно понятно, если бы перечисления поддерживали метод Parse напрямую. С помощью C# 14 и его новой функции членов-расширений мы можем этого добиться.

Следующий код демонстрирует, как добавить методы Parse и TryParse к перечислениям с использованием расширений C# 14:

static class EnumExtensions
{
  extension<T>(T _) where T : struct, Enum
  {
    public static T Parse(string value)
      => Enum.Parse<T>(value);

    public static T Parse(string value, bool ignoreCase)
      => Enum.Parse<T>(value, ignoreCase);

    public static T Parse(ReadOnlySpan<char> value)
      => Enum.Parse<T>(value);

    public static T Parse(
     ReadOnlySpan<char> value,
     bool ignoreCase)
      => Enum.Parse<T>(value, ignoreCase);

    public static bool TryParse(
     [NotNullWhen(true)] string? value,
     out T result)
      => Enum.TryParse(value, out result);

    public static bool TryParse(
     [NotNullWhen(true)] string? value,
     bool ignoreCase,
     out T result)
      => Enum.TryParse(value, ignoreCase, out result);

    public static bool TryParse(
     ReadOnlySpan<char> value,
     out T result)
      => Enum.TryParse(value, out result);

    public static bool TryParse(
     ReadOnlySpan<char> value,
     bool ignoreCase,
     out T result)
      => Enum.TryParse(value, ignoreCase, out result);
  }
}

Теперь мы можем использовать методы Parse/TryParse для самого типа enum, так же как мы это делаем для других типов:

MyEnum.Parse("Value1");

if (MyEnum.TryParse("Value1", out var result))
{
  //…
}

Источник: https://www.meziantou.net/use-csharp-14-extensions-to-simplify-enum-parsing.htm

День 2305. #ЧтоНовенького #TipsAndTricks
Используем Расширения C# 14 для Написания Защитных Конструкций
Продолжаем рассматривать примеры применения ещё не вышедших расширений в C# 14 (первая часть тут).

В C# есть много хороших защитных конструкций, расположенных поверх статических классов исключений, таких как ArgumentNullException, ArgumentOutOfRangeException и т.д. Например, ArgumentException.ThrowIfNullOrEmpty, ArgumentException.ThrowIfNullOrWhiteSpace. Теперь мы можем легко их расширить!

Расширения в C#14 позволяют добавлять новые защитные конструкции к существующим классам. Например, если мы хотим иметь такую «жутко полезную» семантику, как: «Выбрасывать исключение, если строка содержит ровно один символ», мы можем сделать что-то вроде этого:

static class EnumExtensions
{
  extension(ArgumentException)
  {
    public static void 
     ThrowIfHasOneCharacter(
      string arg, 
      [CallerArgumentExpression("arg")]
      string? paramName = null)
    {
      if (arg.Length == 1)
        throw new ArgumentException($"Аргумент '{paramName}' не может иметь только один символ.", paramName);
    }
  }
}

Теперь мы можем использовать этот метод-расширение так:

public void MyMethod(string arg)
{
  ArgumentException.ThrowIfHasOneCharacter(arg);
  …
}

Он прекрасно вливается в семейство существующих защитных конструкций:

public void MyMethod(string arg)
{
  ArgumentException.ThrowIfNullOrEmpty(arg);
  ArgumentException.ThrowIfHasOneCharacter(arg);
  …
}

Конечно, это слишком упрощённый пример. Но вы поняли идею. Мы получаем что-то похожее на существующие защитные конструкции.

Заметьте, что до C#14 этого сделать нельзя, т.к. здесь мы использовали статический метод-расширение, который можно вызвать так:

ArgumentException.ThrowIfHasOneCharacter(…);

Существующие на данный момент методы-расширения позволяют делать только экземплярные методы, которые пришлось бы вызывать так:

var ex = new ArgumentException();
ex.ThrowIfHasOneCharacter(…);

Источник: https://steven-giesel.com/blogPost/e2552b7a-293a-4f46-892f-95a0cd677e4d/writing-new-guards-with-extensions-in-c-14