Merge pull request #16 from Infarh/dev

v0.0.6 - Обновление пакетов (до .NET10)

Author: Infarh

.github/copilot-instructions.md

@@ -0,0 +1,70 @@
+# Правила для GitHub Copilot
+
+- Всегда отвечай, используя русский язык
+- Всегда пиши комментарии в коде на русском языке
+
+## Комментарии
+- Короткие пояснительные комментарии располагай в конце той же строки, что и код // кратко по делу
+- Старайся избегать тривиальных комментариев
+
+## XML‑документация
+- Документируй классы, структуры, делегаты, перечисления и их члены только XML‑комментариями
+- Одинарное предложение пиши в одной строке внутри тега и без точки в конце
+- Каждый тег XML‑комментария располагай на отдельной строке
+- Порядок тегов: `<summary>` → `<param>` → `<returns>` → `<exception>` → `<remarks>` → `<example>`
+- Для сложных публичных метдов генерируй блок с простым примером использования кода внутри тега `<example>`
+
+Примеры:
+- `<summary>Краткое описание сущности</summary>`
+- `<param name="Value">Описание параметра</param>`
+- `<returns>Описание возвращаемого значения</returns>`
+
+## Синтаксис и минимализм
+- При генерации кода используй современные конструкции языка, совместимые с целевыми платформами проекта
+- Стремись минимизировать количество фигурных скобок за счёт expression‑bodied членов и switch‑выражений
+- Не убирай фигурные скобки в многострочных конструкциях ради читаемости
+- Всегда старайся минимизировать размер кода, если не запрошено иное
+
+Разрешённые современные приёмы (когда поддерживается целевой платформой):
+- file‑scoped namespace
+- expression‑bodied члены
+- switch‑выражения и pattern matching
+- target‑typed `new`
+- collection expressions и инициализаторы коллекций
+- `using var` и `await using`
+- операторы `??`, `??=`, `is not`, `with`
+- упрощение nullable-присвоения `target?.Property = 15;` вместо `if(target is not null) target.Property = 15;`
+
+## Именование
+- Локальные переменные: `snake_case`
+- Параметры методов: `PascalCase`
+- Поля экземпляров: `_PascalCase`
+- Статические поля: `__PascalCase`
+- Константы: `PascalCase`
+- Публичные типы и члены API: `PascalCase`
+- Предпочитай английский язык при именовании переменных, методов, классов и прочих сущностей
+
+## Инициализация и объявления
+- При инициализации массивов, списков и словарей используй выражения инициализации массивов/коллекций
+- При объявлении переменных предпочитай использовать ключевое слово `var` (кроме случаев, когда явный тип заметно повышает понятность)
+
+## Форматирование
+- Короткие системные комментарии пиши компактно в одну строку
+- Удаляй неиспользуемые `using`, сортируй и группируй директивы `using`
+- Разделяй логические блоки пустыми строками по мере необходимости, избегай лишних переносов
+
+## Практики .NET
+- Включай `#nullable enable` там, где это поддерживается
+- Используй guard‑выражения, например `ArgumentNullException.ThrowIfNull(x)`
+- Предпочитай Try‑паттерны для контроля потока вместо исключений
+- При генерации метода добавляй в его начале блок проверки входных параметров. Отделяй этот блок пустой строкой от остального тела метода
+- При генерации публичных свойств у моделей-представления MVVM (классов, реализующих INotifyPropertyChanged) используй следующий формат (в одну строку):
+```csharp
+/// <summary>Описание свойства</summary>
+public string PropertyName { get; set => Set(ref field, value); }
+```
+- Для простых лаконичных методов используй expression‑bodied синтаксис, записанный в одну строку.
+
+## Совместимость целей
+- В рабочем пространстве используются целевые платформы: `.NET Standard 2.0` и `.NET 10`
+- Применяй современные возможности языка и платформы только если они доступны для соответствующей целевой платформы проекта

.github/workflows/publish.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: 9.0.x
+          dotnet-version: 10.0.x
 
       - name: Cache NuGet  
         uses: actions/cache@v3
@@ -76,7 +76,7 @@ jobs:
       - name: Install .NET Core
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 8.0.x
+          dotnet-version: 10.0.x
 
       - name: Get artifact
         uses: actions/download-artifact@v4.1.8
@@ -97,7 +97,7 @@ jobs:
       - name: Install .NET Core
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: 8.0.x
+          dotnet-version: 10.0.x
 
       - name: Get artifact
         uses: actions/download-artifact@v4.1.8

.github/workflows/testing.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: 9.0.x
+          dotnet-version: 10.0.x
 
       - name: Cache NuGet  
         uses: actions/cache@v3

MathCore.Hosting.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.31019.35
+# Visual Studio Version 18
+VisualStudioVersion = 18.0.11205.157 d18.0
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MathCore.Hosting", "MathCore.Hosting\MathCore.Hosting.csproj", "{C798853D-64B1-4B61-A0CE-38BFCACC23AB}"
 EndProject
@@ -11,7 +11,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TestWPF", "Tests\TestWPF\Te
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".Common", ".Common", "{870FFA8A-5793-40CF-AF67-199F6CC51250}"
 	ProjectSection(SolutionItems) = preProject
+		.github\copilot-instructions.md = .github\copilot-instructions.md
+		.github\workflows\publish.yml = .github\workflows\publish.yml
 		ReadMe.md = ReadMe.md
+		.github\workflows\testing.yml = .github\workflows\testing.yml
 	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MathCore.Hosting.Tests", "Tests\MathCore.Hosting.Tests\MathCore.Hosting.Tests.csproj", "{8890CFAF-9629-4686-B8C5-B41C693D295F}"

MathCore.Hosting/DynamicPropertyManager.cs

@@ -1,32 +1,30 @@
-using System;
-using System.ComponentModel;
+//using System;
+//using System.ComponentModel;
 
-namespace MathCore.Hosting;
+//namespace MathCore.Hosting;
 
-public class DynamicPropertyManager<T> : IDisposable
-{
-    private DynamicTypeDescriptionProvider _Provider;
-    private class DynamicTypeDescriptionProvider : TypeDescriptionProvider
-    {
+//public class DynamicPropertyManager<T> : IDisposable
+//{
+//    private readonly DynamicTypeDescriptionProvider _Provider;
 
-    }
+//    private class DynamicTypeDescriptionProvider : TypeDescriptionProvider;
 
-    public DynamicPropertiesCollection<T> Properties { get; } = new();
+//    public DynamicPropertiesCollection<T> Properties { get; } = new();
 
-    public DynamicPropertyManager() => TypeDescriptor.AddProvider(_Provider = new DynamicTypeDescriptionProvider(), typeof(T));
+//    public DynamicPropertyManager() => TypeDescriptor.AddProvider(_Provider = new(), typeof(T));
 
-    public void Dispose() => TypeDescriptor.RemoveProvider(_Provider, typeof(T));
-}
+//    public void Dispose() => TypeDescriptor.RemoveProvider(_Provider, typeof(T));
+//}
 
-public class DynamicPropertiesCollection<T>
-{
-    private class DynamicPropertyDescriptor<TProperty>
-    {
+//public class DynamicPropertiesCollection<T>
+//{
+//    private class DynamicPropertyDescriptor<TProperty>
+//    {
 
-    }
+//    }
 
-    public void Add<TProperty>(string Name, Func<TProperty> Getter, Action<TProperty>? Setter = null, Attribute[]? Attributes = null)
-    {
+//    public void Add<TProperty>(string Name, Func<TProperty> Getter, Action<TProperty>? Setter = null, Attribute[]? Attributes = null)
+//    {
 
-    }
-}
+//    }
+//}

MathCore.Hosting/MathCore.Hosting.csproj

@@ -1,14 +1,19 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>netstandard2.0</TargetFramework>
+    <TargetFrameworks>
+      net8.0;
+      net9.0;
+      net10.0;
+      netstandard2.0
+    </TargetFrameworks>
     <LangVersion>preview</LangVersion>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
 
   <PropertyGroup>
-    <Version>0.0.5.1</Version>
+    <Version>0.0.6</Version>
     <PackageReleaseNotes>
       Функциональность регистрации сервисов выделена в отдельный пакет MathCore.DI
     </PackageReleaseNotes>
@@ -36,8 +41,8 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="MathCore.DI" Version="0.0.3.1" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.1" />
+    <PackageReference Include="MathCore.DI" Version="0.0.4" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.0" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
   </ItemGroup>
 

MathCore.Hosting/ServiceLocator.cs

@@ -4,8 +4,12 @@
 
 namespace MathCore.Hosting;
 
+/// <summary>Базовый локатор сервисов с доступом к зависимостям через dynamic</summary>
 public abstract class ServiceLocator : DynamicObject
 {
+    /// <summary>Заполняет внутренний кэш доступных сервисов на основе текущих регистраций</summary>
+    /// <param name="services">Коллекция сервисов DI</param>
+    /// <remarks>При совпадении имён типов берётся первая регистрация</remarks>
     public static void ConfigureServices(IServiceCollection services)
     {
         var result = new Dictionary<string, (Type? Type, Func<IServiceProvider, object>? Factory)>();
@@ -19,12 +23,19 @@ public static void ConfigureServices(IServiceCollection services)
         __Services = result;
     }
 
+    /// <summary>Кэш соответствий имён сервисов их типам или фабрикам</summary>
     private static Dictionary<string, (Type? Type, Func<IServiceProvider, object>? Factory)> __Services = new();
 
+    /// <summary>Провайдер сервисов, используемый локатором для разрешения зависимостей</summary>
     protected abstract IServiceProvider Services { get; }
 
-    /// <inheritdoc />
-    public override bool TryGetMember(GetMemberBinder binder, out object result)
+    /// <summary>Пытается получить сервис по имени динамического члена</summary>
+    /// <param name="binder">Объект привязки динамического члена</param>
+    /// <param name="result">Найденный экземпляр сервиса или null</param>
+    /// <returns>Истина, если сервис получен успешно</returns>
+    /// <exception cref="InvalidOperationException">Если тип найден, но экземпляр не может быть разрешён контейнером</exception>
+    /// <remarks>Сначала используется фабрика реализации, затем тип и провайдер сервисов</remarks>
+    public override bool TryGetMember(GetMemberBinder binder, out object? result)
     {
         if (base.TryGetMember(binder, out result))
             return true;
@@ -42,5 +53,7 @@ public override bool TryGetMember(GetMemberBinder binder, out object result)
         return true;
     }
 
+    /// <summary>Возвращает имена доступных динамических членов</summary>
+    /// <returns>Перечень имён сервисов, доступных через локатор</returns>
     public override IEnumerable<string> GetDynamicMemberNames() => __Services.Keys;
 }