v0.0.49

.github/copilot-instructions.md

@@ -67,4 +67,19 @@ public string PropertyName { get; set => Set(ref field, value); }
 
 ## Совместимость целей
 - В рабочем пространстве используются целевые платформы: `.NET Standard 2.0` и `.NET 10`
-- Применяй современные возможности языка и платформы только если они доступны для соответствующей целевой платформы проекта
+- Применяй современные возможности языка и платформы только если они доступны для соответствующей целевой платформы проекта
+
+## Модульные тесты с использованием MSTest
+- Используй платформу MSTest для написания модульных тестов
+- Классы тестов должны быть помечены атрибутом `[TestClass]`
+- Методы тестов должны быть помечены атрибутом `[TestMethod]`
+- Для параметризованных тестов используй `[DataTestMethod]` и `[DataRow]`
+- Следуй паттерну Arrange-Act-Assert (AAA) при написании тестов
+- Каждый тест должен проверять только одно поведение
+- Избегай использования статических полей в тестах
+- Убедись, что тесты могут выполняться в любом порядке и параллельно
+- Для проверки исключений используй `Assert.ThrowsException`
+- Используй `Debug.WriteLine` для вывода отладочной информации о процессе выполнения тестов, если в тесте есть промежуточные вычисления
+- При написании Assert-методов добавляй сообщения об ошибках на русском языке
+- Файлы модульных тестов должны создаваться с учётом структуры каталогов тестируемого кода
+- Каждый модульный тест должен быть снабжён XML‑документацией, описывающей его назначение и поведение 

.github/workflows/publish.yml

@@ -22,17 +22,17 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: 10.0.x
 
       - name: Cache NuGet  
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.nuget/packages
           key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
@@ -46,7 +46,7 @@ jobs:
 
       - name: Building
         run: |
-          dotnet build MathCore.WPF -c Release --no-restore --nowarn:CS1998,CS8625,CS8600,CS8603,CS8620,CS8618,CS8604,CS8602,CS8622,CS8619,CS8632,CS0108,NU1701,NU1702,MSB3277,NU1701
+          dotnet build MathCore.WPF -c Release --no-restore --nowarn:CS1998,CS8625,CS8600,CS8603,CS8620,CS8618,CS8604,CS8602,CS8622,CS8619,CS8632,CS0108,NU1701,NU1702,MSB3277,NU1701,CS1591
           dotnet build Tests/MathCore.WPF.Tests -c Release --no-restore
 
       - name: Test
@@ -56,7 +56,7 @@ jobs:
         run: dotnet pack MathCore.WPF/MathCore.WPF.csproj --no-build -c Release -v q -o ${{ github.workspace }}/ReleasePack --include-symbols
 
       - name: Upload build artifacts
-        uses: actions/upload-artifact@v4.4.3
+        uses: actions/upload-artifact@v6.0.0
         with:
           name: Release
           path: ${{ github.workspace }}/ReleasePack
@@ -69,7 +69,7 @@ jobs:
 
     steps:    
       - name: Get artifact
-        uses: actions/download-artifact@v5
+        uses: actions/download-artifact@v7
         id: download
         with:
             name: Release
@@ -85,7 +85,7 @@ jobs:
 
     steps:    
       - name: Get artifact
-        uses: actions/download-artifact@v5
+        uses: actions/download-artifact@v7
         id: download
         with:
             name: Release

.github/workflows/testing.yml

@@ -33,12 +33,12 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: 10.0.x
 

.tools/nuget-get-last-version.cs

@@ -0,0 +1,120 @@
+#!/usr/bin/env dotnet
+#:package NuGet.Protocol@6.10.1
+#:package NuGet.Configuration@6.10.1
+#:package NuGet.Versioning@6.10.1
+#:package NuGet.Common@6.10.1
+
+/*
+Использование:
+    dotnet run nuget-get-last-version.cs [<путь_к_.csproj> | <идентификатор_пакета>]
+
+
+Коды возврата:
+    0  — успешное завершение
+   -1  — запрос помощи (--help, -h)
+   -2  — ошибка использования (отсутствует аргумент, пустой аргумент)
+    1  — непредвиденная ошибка выполнения (catch)
+    2  — ошибка чтения/парсинга .csproj
+    3  — отсутствуют элементы <PackageReference> в .csproj
+    5  — версия пакета не найдена
+*/
+
+using System;
+using System.IO;
+using System.Linq;
+using System.Xml.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using NuGet.Configuration;
+using NuGet.Protocol;
+using NuGet.Protocol.Core.Types;
+using NuGet.Versioning;
+using NuGet.Common; // для NullLogger
+
+if (args.Length < 1)
+{
+    Console.Error.WriteLine("Не указан путь к .csproj"); // ошибка использования
+    Console.Out.WriteLine("Использование: dotnet run nuget-get-last-version.cs [<путь_к_.csproj> | <идентификатор_пакета>]");
+    Environment.Exit(-2);
+}
+
+var input = args[0].Trim();
+if (input.Length == 0)
+{
+    Console.Error.WriteLine("Аргумент пуст"); // ошибка использования
+    Console.Out.WriteLine("Использование: dotnet run nuget-get-last-version.cs [<путь_к_.csproj> | <идентификатор_пакета>]");
+    Environment.Exit(-2);
+}
+
+if(input == "--help" || input == "-h")
+{
+    Console.Out.WriteLine("Использование: dotnet run nuget-get-last-version.cs [<путь_к_.csproj> | <идентификатор_пакета>]");
+    Environment.Exit(-1);
+}
+
+// Если передан путь к .csproj, извлечь идентификатор пакета из PackageReference
+string package_id;
+if (File.Exists(input) && string.Equals(Path.GetExtension(input), ".csproj", StringComparison.OrdinalIgnoreCase))
+    try
+    {
+        var xml = XDocument.Load(input); // загрузка проекта
+        // Пытаемся найти ссылку на пакет MathCore, иначе берём первый PackageReference
+        var pkg_mathcore = xml
+            .Root?
+            .Descendants("PackageReference")
+            .FirstOrDefault(e => string.Equals((string?)e.Attribute("Include"), "MathCore", StringComparison.OrdinalIgnoreCase));
+
+        var pkg = pkg_mathcore ?? xml.Root?.Descendants("PackageReference").FirstOrDefault();
+        package_id = (string?)pkg?.Attribute("Include") ?? string.Empty;
+
+        if (string.IsNullOrWhiteSpace(package_id))
+        {
+            Console.Error.WriteLine("В .csproj не найдены элементы <PackageReference>"); // отсутствуют требуемые данные
+            Environment.Exit(3);
+        }
+    }
+    catch (Exception e)
+    {
+        Console.Error.WriteLine($"Ошибка чтения .csproj: {e.Message}"); // ошибка парсинга
+        Environment.Exit(2);
+        return;
+    }
+else
+    package_id = input; // непосредственно ID пакета
+
+try
+{
+    if (await GetLatestStableVersionAsync(package_id, CancellationToken.None) is not { } version)
+    {
+        Console.Error.WriteLine($"Не удалось определить последнюю версию пакета {package_id}"); // ресурс/версия не найдены
+        Environment.Exit(5);
+    }
+
+    Console.Out.Write(version.ToString()); // вывод версии
+}
+catch (Exception e)
+{
+    Console.Error.WriteLine($"Ошибка: {e.Message}"); // общая непредвиденная ошибка выполнения
+    Environment.Exit(1);
+}
+
+static async Task<NuGetVersion?> GetLatestStableVersionAsync(string PackageId, CancellationToken Cancel)
+{
+    var providers = Repository.Provider.GetCoreV3(); // провайдеры ресурсов
+    var source = new PackageSource("https://api.nuget.org/v3/index.json"); // индекс nuget.org
+    var repo = new SourceRepository(source, providers);
+
+    var metadata = await repo.GetResourceAsync<PackageMetadataResource>(Cancel); // ресурс метаданных
+    var search = await metadata.GetMetadataAsync(
+        PackageId,
+        includePrerelease: true,
+        includeUnlisted: false,
+        new SourceCacheContext(),
+        NullLogger.Instance,
+        Cancel);
+
+    var versions = search.Select(m => m.Identity.Version).OrderBy(v => v); // сортировка по возрастанию
+    var latest_stable = versions.LastOrDefault(v => !v.IsPrerelease); // последняя стабильная
+
+    return latest_stable ?? versions.LastOrDefault(); // если стабильной нет, взять последнюю вообще
+}

.tools/version.cs

@@ -0,0 +1,50 @@
+#!/usr/bin/env dotnet
+
+using System;
+using System.IO;
+using System.Linq;
+using System.Xml.Linq;
+
+if (args.Length < 1)
+{
+    Console.Error.WriteLine("Укажите путь к .csproj файлу"); // проверка аргументов
+    Environment.Exit(1);
+}
+
+var project_path = args[0]; // путь к проекту
+
+if (!File.Exists(project_path))
+{
+    Console.Error.WriteLine($"Файл не найден: {project_path}"); // проверка наличия файла
+    Environment.Exit(2);
+}
+
+XDocument doc;
+try
+{
+    doc = XDocument.Load(project_path); // загрузка XML
+}
+catch (Exception e)
+{
+    Console.Error.WriteLine($"Ошибка загрузки XML: {e.Message}"); // ошибка парсинга
+    Environment.Exit(3);
+    return;
+}
+
+// поиск версии в PropertyGroup/Version
+var version = doc
+    .Root?
+    .Descendants("PropertyGroup")
+    .Elements("Version")
+    .Select(v => (string?)v.Value)
+    .FirstOrDefault(v => !string.IsNullOrWhiteSpace(v));
+
+if (string.IsNullOrWhiteSpace(version))
+{
+    Console.Error.WriteLine("Свойство <Version> не найдено"); // версия не обнаружена
+    Environment.Exit(4);
+}
+else
+{
+    Console.Out.Write(version.Trim()); // вывод версии в stdout
+}

MathCore.WPF.slnx

@@ -0,0 +1,23 @@
+<Solution>
+  <Folder Name="/.Service/">
+    <File Path=".editorconfig" />
+    <File Path=".tools/version.cs" />
+  </Folder>
+  <Folder Name="/.Service/.github/">
+    <File Path=".github/copilot-instructions.md" />
+  </Folder>
+  <Folder Name="/.Service/.github/workflows/">
+    <File Path=".github/workflows/publish.yml" />
+    <File Path=".github/workflows/testing.yml" />
+  </Folder>
+  <Folder Name="/.Service/tools/">
+    <File Path=".tools/nuget-get-last-version.cs" />
+    <File Path=".tools/version.cs" />
+  </Folder>
+  <Folder Name="/Tests/">
+    <Project Path="Tests/MathCore.WPF.ConsoleTest/MathCore.WPF.ConsoleTest.csproj" />
+    <Project Path="Tests/MathCore.WPF.Tests/MathCore.WPF.Tests.csproj" />
+    <Project Path="Tests/MathCore.WPF.WindowTest/MathCore.WPF.WindowTest.csproj" />
+  </Folder>
+  <Project Path="MathCore.WPF/MathCore.WPF.csproj" />
+</Solution>