Больше документации!

Pf2eDataScrapper/EnvSettings.cs

@@ -1,26 +1,39 @@
-using System;
+using dotenv.net;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using dotenv.net;
 using dotenv.net.Utilities;
 
 namespace Pf2eDataScrapper
 {
-    internal class EnvSettings
+    /// <summary>
+    /// Класс настроек.
+    /// </summary>
+    internal static class EnvSettings
     {
+        /// <summary>
+        /// Загрузка файла настроек `.env`.
+        /// </summary>
         public static void Load()
         {
             DotEnv.Load();
         }
 
+        /// <summary>
+        /// Путь к папке с входными данными.
+        /// </summary>
         public static string DataDirPath => EnvReader.GetStringValue("DATA_DIR");
 
+        /// <summary>
+        /// Папка в входными данными.
+        /// </summary>
         public static DirectoryInfo DataDir => new(DataDirPath);
 
+        /// <summary>
+        /// Путь к папке для сохранения результатов.
+        /// </summary>
         public static string OutputDirPath => EnvReader.GetStringValue("OUTPUT_DIR");
 
+        /// <summary>
+        /// Папка для сохранения результатов.
+        /// </summary>
         public static string OutputDir => new(OutputDirPath);
 
     }

Pf2eDataScrapper/Importers/AbstractImporter.cs

@@ -1,11 +1,8 @@
-using System;
+namespace Pf2eDataScrapper.Importers
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace Pf2eDataScrapper.Importers
 {
+    /// <summary>
+    /// Абстрактный класс импортёра
+    /// </summary>
     internal abstract class AbstractImporter
     {
         /// <summary>
@@ -28,7 +25,14 @@ namespace Pf2eDataScrapper.Importers
         /// </summary>
         public string Dir => Path.Combine(EnvSettings.DataDirPath, Slug);
 
+        /// <summary>
+        /// Метод подготовки данных для импорта
+        /// </summary>
         public abstract void Prepare();
+
+        /// <summary>
+        /// Импорт данных
+        /// </summary>
         public abstract void Import();
 
     }

Pf2eDataScrapper/Importers/GitLoader.cs

@@ -1,20 +1,30 @@
-using System;
+using System.Diagnostics;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Pf2eDataScrapper.Importers
 {
-    internal class GitLoader(string DataDirPath)
+    /// <summary>
+    /// Загрузчик данных из git-репозиториев
+    /// </summary>
+    /// <param name="repositoryDirPath"></param>
+    internal class GitLoader(string repositoryDirPath)
     {
-        public readonly string DataDirPath = DataDirPath;
+        /// <summary>
-        public DirectoryInfo DataDir = new(DataDirPath);
+        /// Путь к директории репозитория
+        /// </summary>
+        public readonly string RepositoryDirPath = repositoryDirPath;
 
+        /// <summary>
+        /// Директория репозитория
+        /// </summary>
+        public DirectoryInfo RepositoryDir = new(repositoryDirPath);
+
+        /// <summary>
+        /// Обновление импортёра
+        /// </summary>
+        /// <param name="importer"></param>
         public void UpdateImporter(AbstractImporter importer)
         {
-            string gitPath = Path.Combine(DataDirPath, importer.Slug);
+            var gitPath = Path.Combine(RepositoryDirPath, importer.Slug);
 
             if (Directory.Exists(gitPath))
             {
@@ -38,7 +48,7 @@ namespace Pf2eDataScrapper.Importers
                     StartInfo = new ProcessStartInfo()
                     {
                         FileName = "git",
-                        WorkingDirectory = DataDirPath,
+                        WorkingDirectory = RepositoryDirPath,
                         Arguments = $"clone {importer.GitUrl} {importer.Slug}",
                     }
                 };

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/Compendium/CompendiumDocumentType.cs

@@ -1,11 +1,8 @@
-using System;
+namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
 {
+    /// <summary>
+    /// Тип документов компендиума.
+    /// </summary>
     internal enum CompendiumDocumentType
     {
         Actor,

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/Compendium/CompendiumFolder.cs

@@ -1,32 +1,52 @@
-using System;
+using Newtonsoft.Json.Linq;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Newtonsoft.Json.Linq;
 
 namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
 {
+    /// <summary>
+    /// Папка компендиума.
+    /// </summary>
     internal class CompendiumFolder
     {
+        /// <summary>
+        /// Идентификатор папки.
+        /// </summary>
         public readonly string Id;
 
+        /// <summary>
+        /// Название папки.
+        /// </summary>
         public readonly string Name;
 
+        /// <summary>
+        /// Путь к папке.
+        /// </summary>
         public readonly string? Path;
 
+        /// <summary>
+        /// Указатель, что папка содержится в других папках.
+        /// </summary>
         public readonly bool IsContained;
 
+        /// <summary>
+        /// Родительская папка.
+        /// </summary>
         public CompendiumFolder? Parent;
 
+        /// <summary>
+        /// Тип документов в папке.
+        /// </summary>
         public readonly CompendiumDocumentType Type;
 
+        /// <summary>
+        /// Конструктор папки компендиума из JSON-объекта.
+        /// </summary>
+        /// <param name="json"></param>
         public CompendiumFolder(JObject json)
         {
-            if (json.ContainsKey("_id"))
+            if (json.TryGetValue("_id", out var id))
             {
                 // Вложенная папка через _folders.json
-                Id = json["_id"]!.ToString();
+                Id = id!.ToString();
                 Name = json["name"]!.ToString();
                 Path = null;
                 IsContained = true;
@@ -43,6 +63,11 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
             Type = (CompendiumDocumentType)Enum.Parse(typeof(CompendiumDocumentType), json["type"]!.ToString());
         }
 
+        /// <summary>
+        /// Конструктор папки компендиума.
+        /// </summary>
+        /// <param name="id">Идентификатор папки.</param>
+        /// <param name="name">Название папки.</param>
         public CompendiumFolder(string id, string name)
         {
             Id = id;
@@ -51,6 +76,10 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
             IsContained = false;
         }
 
+        /// <summary>
+        /// Строковое представление данных о папки компендиума.
+        /// </summary>
+        /// <returns>Строковое представление данных о папки компендиума.</returns>
         public override string ToString()
         {
             return $"CompendiumFolder([Id={Id}][Type={Type}][Name={Name}][Path={Path}][Parent={Parent?.Name ?? "null"}])";

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/Compendium/CompendiumFolderCollection.cs

@@ -1,14 +1,15 @@
-using System;
+namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
 {
+    /// <summary>
+    /// Коллекция папок компендиума
+    /// </summary>
     internal class CompendiumFolderCollection : List<CompendiumFolder>
     {
-
+        /// <summary>
+        /// Получение папки по идентификатору
+        /// </summary>
+        /// <param name="id">Искомый идентификатор</param>
+        /// <returns>Искомая папка</returns>
         public CompendiumFolder? GetById(string id)
         {
             return this.FirstOrDefault(x => x.Id == id);

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/Compendium/CompendiumSchemaBuilder.cs

@@ -1,27 +1,46 @@
 using Konsole;
 using Newtonsoft.Json.Linq;
 using Pf2eDataScrapper.SchemaBuilder;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
 {
+    /// <summary>
+    /// Класс построения схемы компендиумов.
+    /// </summary>
+    /// <param name="loader">Загрузчик данных.</param>
     internal class CompendiumSchemaBuilder(CompendiumLoader loader)
     {
+        /// <summary>
+        /// Загрузчик данных.
+        /// </summary>
         public CompendiumLoader Loader = loader;
 
+        /// <summary>
+        /// Коллекция папок компендиума.
+        /// </summary>
         public CompendiumFolderCollection Collection = loader.Collection;
 
+        /// <summary>
+        /// Объект для определения типов полей в компендиумах PF2E.
+        /// </summary>
         public CompendiumSchemaTypeResolver Resolver = new();
 
+        /// <summary>
+        /// Схемы данных по папкам.
+        /// </summary>
         public Dictionary<CompendiumFolder, SchemaNode> PackSchemas = [];
 
+        /// <summary>
+        /// Схемы данных по типам.
+        /// </summary>
         public Dictionary<string, SchemaNode> TypeSchemas = [];
 
-        
+        /// <summary>
+        /// Получение набора схем, к которым относится проверяемый объект.
+        /// </summary>
+        /// <param name="folder">Папка компендиума, в которой находится объект.</param>
+        /// <param name="itemType">Указанный тип объекта.</param>
+        /// <returns></returns>
         protected List<SchemaNode> GetItemSchemas(CompendiumFolder folder, string? itemType)
         {
             if (!PackSchemas.ContainsKey(folder))
@@ -47,6 +66,9 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
             return [PackSchemas[folder], TypeSchemas[key]];
         }
 
+        /// <summary>
+        /// Построение схем данных.
+        /// </summary>
         public void BuildSchemas()
         {
             Console.WriteLine("Building schemas...");
@@ -90,6 +112,10 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
             bar.Refresh(Loader.ItemCount, "Done!");
         }
 
+        /// <summary>
+        /// Сохранение данных.
+        /// </summary>
+        /// <param name="targetDir">Папка для сохранения.</param>
         public void Save(string targetDir)
         {
             Console.WriteLine("Dumping schemas...");
@@ -127,6 +153,12 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
             Console.WriteLine("Done!");
         }
 
+        /// <summary>
+        /// Сохранение конкретной схемы.
+        /// </summary>
+        /// <param name="dir">Корневая папка для сохранения этой категории схем.</param>
+        /// <param name="name">Название сохраняемой схемы.</param>
+        /// <param name="schema">Сохраняемая схема.</param>
         protected void SaveSchema(string dir, string name, SchemaNode schema)
         {
             var invalids = System.IO.Path.GetInvalidFileNameChars();
@@ -134,7 +166,6 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium
 
             var path = Path.Combine(dir, fileName + ".txt");
 
-
             var dirPath = Path.GetDirectoryName(path);
 
             if (!Directory.Exists(dirPath))

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/CompendiumLoader.cs

@@ -1,22 +1,39 @@
-using System.Reflection.PortableExecutable;
+using Newtonsoft.Json.Linq;
-using System.Text.RegularExpressions;
-using Konsole;
-using Newtonsoft.Json.Linq;
 using Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry.Compendium;
-using Pf2eDataScrapper.SchemaBuilder;
 
 namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry
 {
-    internal class CompendiumLoader(Pf2eFoundryImporter importer)
+    /// <summary>
+    /// Загрузчик данных компендиума
+    /// </summary>
+    /// <param name="importer">Импортёр</param>
+    internal class CompendiumLoader(Pf2EFoundryImporter importer)
     {
-        public readonly Pf2eFoundryImporter Importer = importer;
+        /// <summary>
+        /// Импортёр
+        /// </summary>
+        public readonly Pf2EFoundryImporter Importer = importer;
 
+        /// <summary>
+        /// Набор папок компендиума
+        /// </summary>
         public CompendiumFolderCollection Collection = [];
 
+        /// <summary>
+        /// Счётчик папок
+        /// </summary>
         private int _folderCount = 0;
 
+        /// <summary>
+        /// Общее количество элементов в компендиуме
+        /// </summary>
         public int ItemCount { get; protected set; } = 0;
 
+        /// <summary>
+        /// Обработка папок компендиума в поле `packFolders`.
+        /// </summary>
+        /// <param name="folders"></param>
+        /// <param name="parent"></param>
         protected void ProcessPackFolders(JArray folders, CompendiumFolder? parent)
         {
             foreach (var token in folders)
@@ -53,6 +70,9 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry
             }
         }
 
+        /// <summary>
+        /// Подготовка набора папок компендиума
+        /// </summary>
         public void Prepare()
         {
             using var systemFile = new StreamReader(Path.Combine(Importer.Dir, "static", "system.json"));
@@ -104,10 +124,5 @@ namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry
 
             Console.WriteLine($"Total items: {ItemCount}");
         }
-
-        public void Run()
-        {
-            this.Prepare();
-        }
     }
 }

Pf2eDataScrapper/Importers/Implementations/Pf2eFoundry/Pf2eFoundryImporter.cs

@@ -1,43 +1,52 @@
-using System;
+namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace Pf2eDataScrapper.Importers.Implementations.Pf2eFoundry
 {
-    internal class Pf2eFoundryImporter : AbstractImporter
+    /// <summary>
+    /// Импортёр для модуля Pf2e FoundryVTT.
+    /// </summary>
+    internal class Pf2EFoundryImporter : AbstractImporter
     {
         /// <summary>
-        /// Отображаемое имя импортёра
+        /// Отображаемое имя импортёра.
         /// </summary>
         public override string Name => "Pf2e FoundryVTT module";
 
         /// <summary>
-        /// Короткое имя импортёра
+        /// Короткое имя импортёра.
         /// </summary>
         public override string Slug => "pf2e";
 
         /// <summary>
-        /// Ссылка на git-репозиторий для клонирования
+        /// Ссылка на git-репозиторий для клонирования.
         /// </summary>
         public override string GitUrl => "https://github.com/foundryvtt/pf2e.git";
 
+        /// <summary>
+        /// Загрузчик данных компендиума.
+        /// </summary>
         public CompendiumLoader Loader { get; }
 
-        public Pf2eFoundryImporter()
+        /// <summary>
+        /// Конструктор импортёра.
+        /// </summary>
+        public Pf2EFoundryImporter()
         {
             Loader = new CompendiumLoader(this);
         }
 
+        /// <summary>
+        /// Метод подготовки данных для импорта.
+        /// </summary>
         public override void Prepare()
         {
             Loader.Prepare();
         }
 
+        /// <summary>
+        /// Импорт данных.
+        /// </summary>
         public override void Import()
         {
-            Loader.Run();
+            Loader.Prepare();
         }
     }
 }

Pf2eDataScrapper/Program.cs

@@ -9,10 +9,10 @@ EnvSettings.Load();
 
 Console.WriteLine("Hello, World!");
 
-//var loader = new GitLoader(EnvSettings.DataDirPath);
+//var loader = new GitLoader(EnvSettings.RepositoryDirPath);
 
 
-var importer = new Pf2eFoundryImporter();
+var importer = new Pf2EFoundryImporter();
 
 //loader.UpdateImporter(importer);
 

Pf2eDataScrapper/SchemaBuilder/SchemaNode.cs

@@ -1,41 +1,76 @@
-using System;
+using Newtonsoft.Json.Linq;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Newtonsoft.Json.Linq;
 using Pf2eDataScrapper.SchemaBuilder.Types;
 
 namespace Pf2eDataScrapper.SchemaBuilder
 {
+    /// <summary>
+    /// Элемент схемы данных.
+    /// </summary>
     internal class SchemaNode
     {
+        /// <summary>
+        /// Отображаемое имя элемента.
+        /// </summary>
         public string Name = "";
 
+        /// <summary>
+        /// Путь к элементу.
+        /// </summary>
         public string Path = "";
 
+        /// <summary>
+        /// Родительский элемент.
+        /// </summary>
         public SchemaNode? Parent = null;
 
+        /// <summary>
+        /// Указание, является ли элемент корневым.
+        /// </summary>
         public bool Root = false;
 
+        /// <summary>
+        /// Корневой элемент схемы данных.
+        /// </summary>
         public SchemaNode RootNode => Root ? this : Parent!.RootNode;
 
+        /// <summary>
+        /// Типы данных, использующиеся в элементе.
+        /// </summary>
         public List<AbstractSchemaType> Types = [];
 
+        /// <summary>
+        /// Указание, может ли этот элемент отсутсвовать в структуре данных.
+        /// </summary>
         public bool IsNullable = false;
 
+        /// <summary>
+        /// Объект для определения типа поля в схеме данных.
+        /// </summary>
         public TypeResolver Resolver = new();
 
+        /// <summary>
+        /// Количество значений, добавленных в тип.
+        /// </summary>
         public int Values { get; protected set; } = 0;
 
+        /// <summary>
+        /// Указание, является ли тип элемента простым.
+        /// </summary>
         public bool IsSimple => Types.Count == 1;
 
+        /// <summary>
+        /// Конструктор корневого элемента.
+        /// </summary>
         public SchemaNode() 
         {
             this.Root = true;
         }
 
+        /// <summary>
+        /// Конструктор элемента схемы данных.
+        /// </summary>
+        /// <param name="parent">Родительский элемент.</param>
+        /// <param name="name">Имя элемента.</param>
         public SchemaNode(SchemaNode parent, string name)
         {
             this.Parent = parent;
@@ -44,6 +79,10 @@ namespace Pf2eDataScrapper.SchemaBuilder
             this.Resolver = parent.Resolver;
         }
 
+        /// <summary>
+        /// Добавление нового возможного значения.
+        /// </summary>
+        /// <param name="value">Добавляемое значение</param>
         public void AddValue(JToken? value)
         {
             if (value is null || Resolver.TokenType(value) == JTokenType.Null)
@@ -68,6 +107,10 @@ namespace Pf2eDataScrapper.SchemaBuilder
             Types.Add(newType);
         }
 
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public string GetTypeName()
         {
             if (IsSimple)
@@ -75,11 +118,15 @@ namespace Pf2eDataScrapper.SchemaBuilder
                 return Types[0].GetTypeName();
             }
 
-            List<string> typeNames = Types.Select(t => t.GetTypeName()).ToList();
+            var typeNames = Types.Select(t => t.GetTypeName()).ToList();
 
             return string.Join("|", typeNames);
         }
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             if (IsSimple)
@@ -97,6 +144,9 @@ namespace Pf2eDataScrapper.SchemaBuilder
             return string.Join("\n" + AbstractSchemaType.Tab, result);
         }
 
+        /// <summary>
+        /// Подготовка элемента к красивому представлению.
+        /// </summary>
         public void Beautify()
         {
             foreach (var type in Types)

Pf2eDataScrapper/SchemaBuilder/TypeResolver.cs

@@ -1,15 +1,19 @@
-using System;
+using Newtonsoft.Json.Linq;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Newtonsoft.Json.Linq;
 using Pf2eDataScrapper.SchemaBuilder.Types;
 
 namespace Pf2eDataScrapper.SchemaBuilder
 {
+    /// <summary>
+    /// Класс для определения типа поля в схеме данных.
+    /// </summary>
     internal class TypeResolver
     {
+        /// <summary>
+        /// Проверка соответствия пути.
+        /// </summary>
+        /// <param name="node">Элемент, путь которого проверяется.</param>
+        /// <param name="path">Проверяемый путь. Допускается использование `*` в местах, где допускается любое значение.</param>
+        /// <returns>`true`, если `node.Path` соответсвует указанному в `path` значению.</returns>
         public bool CheckPath(SchemaNode node, string path)
         {
             if (!path.Contains("*"))
@@ -27,12 +31,23 @@ namespace Pf2eDataScrapper.SchemaBuilder
 
             return !pathParts.Where((t, i) => t != "*" && t != nodeParts[i]).Any();
         }
-        
+
+        /// <summary>
+        /// Проверка соответствия пути.
+        /// </summary>
+        /// <param name="node">Элемент, путь которого проверяется.</param>
+        /// <param name="paths">Проверяемые пути. Допускается использование `*` в местах, где допускается любое значение.</param>
+        /// <returns>`true`, если `node.Path` соответсвует хотя бы одному указанному в `paths` значению.</returns>
         public bool CheckPath(SchemaNode node, ICollection<string> paths)
         {
             return paths.Any(path => CheckPath(node, path));
         }
 
+        /// <summary>
+        /// Получение типа значения.
+        /// </summary>
+        /// <param name="value">Значение.</param>
+        /// <returns>Типа значения.</returns>
         public JTokenType TokenType(JToken? value)
         {
             if (value is null || value.Type is JTokenType.Null or JTokenType.Undefined or JTokenType.None)
@@ -43,13 +58,23 @@ namespace Pf2eDataScrapper.SchemaBuilder
             return value.Type;
         }
 
+        /// <summary>
+        ///     Определение типа поля.
+        /// </summary>
+        /// <param name="node">Поле схемы данных, для которого создаётся тип.</param>
+        /// <param name="value">Добавляемое значение.</param>
+        /// <returns>Новый тип для схемы данных</returns>
+        /// <exception cref="ArgumentNullException">
+        ///     Возникает, если у `value` значение идентично `null`
+        ///     (такие значения должны обрабаотываться в `SchemaNode`).
+        /// </exception>
         public virtual AbstractSchemaType Resolve(SchemaNode node, JToken? value)
         {
             var type = TokenType(value);
 
             if (type == JTokenType.Null)
             {
-                throw new Exception("Value is null, cannot determine type");
+                throw new ArgumentNullException();
             }
 
             return type switch

Pf2eDataScrapper/SchemaBuilder/Types/AbstractSchemaType.cs

@@ -1,58 +1,76 @@
-using System.ComponentModel.Design.Serialization;
+using Newtonsoft.Json.Linq;
-using Newtonsoft.Json.Linq;
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Абстрактный тип представоления данных в схеме.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
     internal abstract class AbstractSchemaType(SchemaNode parent)
     {
+        /// <summary>
+        /// Элемент схемы данных, к которому относится тип.
+        /// </summary>
         public SchemaNode Parent = parent;
 
+        /// <summary>
+        /// Корневой элемент схемы данных.
+        /// </summary>
         public SchemaNode Root => Parent.RootNode;
 
+        /// <summary>
+        /// Объект для определения типа поля в схеме данных.
+        /// </summary>
         public TypeResolver Resolver => Root.Resolver;
 
         /// <summary>
-        /// Check if type is compatible with current type.
+        /// Проверка, что значение совместимо с текущим типом.
         /// </summary>
-        /// <param name="value">Value to be checked</param>
+        /// <param name="value">Проверяемое значение.</param>
-        /// <returns>True if value is compatible with current type</returns>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public abstract bool IsCompatibleValue(JToken value);
 
         /// <summary>
-        /// Add new possible value.
+        /// Добавление нового значения.
         /// </summary>
-        /// <param name="value">New value</param>
+        /// <param name="value">Новое значение.</param>
         public abstract void AddValue(JToken value);
 
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public abstract void Beautify();
 
         /// <summary>
-        /// String representation of type.
+        /// Получение строкового представоения типа элемента.
         /// </summary>
-        /// <returns></returns>
+        /// <returns>Строковое представоение типа элемента</returns>
         public abstract string GetTypeName();
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             return $"{GetTypeName()} {Parent.Path}";
         }
-
+        
-
         /// <summary>
-        /// Tabulation characters.
+        /// Отступ для строкового представления.
         /// </summary>
         public const string Tab = "    ";
 
         /// <summary>
-        /// Limit of elements in list or dictionary to be displayed.
+        /// Предел количество отображаемых элементов.
         /// </summary>
-        public const int ElementLimit = 20;
+        public const int ElementLimit = 10;
 
         /// <summary>
-        /// Indent text.
+        /// Увеличение отступа строки.
         /// </summary>
-        /// <param name="text">Text to be indented</param>
+        /// <param name="text">Изменяемая строка.</param>
-        /// <returns>Indented text</returns>
+        /// <returns>Строка с добавленными отступами.</returns>
         public static string Indent(string text)
         {
             return text.Replace("\n", "\n" + Tab);

Pf2eDataScrapper/SchemaBuilder/Types/ArraySchemaType.cs

@@ -1,28 +1,42 @@
-using System;
+using Newtonsoft.Json.Linq;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using System.Transactions;
-using Newtonsoft.Json.Linq;
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Тип представоления массива в схеме.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
     internal class ArraySchemaType(SchemaNode parent) : AbstractSchemaType(parent)
     {
+        /// <summary>
+        /// Минимальное количество элементов в массиве.
+        /// </summary>
         public int MinCount = int.MaxValue;
 
+        /// <summary>
+        /// Максимальное количество элементов в массиве.
+        /// </summary>
         public int MaxCount = int.MinValue;
 
+        /// <summary>
+        /// Схема элемента массива.
+        /// </summary>
         protected SchemaNode ElementSchema = new(parent, "[]");
 
-        protected List<JToken?> Values = [];
+        /// <summary>
-        
+        /// Проверка, что значение совместимо с текущим типом.
+        /// </summary>
+        /// <param name="value">Проверяемое значение.</param>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public override bool IsCompatibleValue(JToken value)
         {
             return Resolver.TokenType(value) == JTokenType.Array;
         }
 
+        /// <summary>
+        /// Добавление нового значения.
+        /// </summary>
+        /// <param name="value">Новое значение.</param>
         public override void AddValue(JToken value)
         {
             if (value.Type != JTokenType.Array)
@@ -41,16 +55,27 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             }
         }
 
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public override void Beautify()
         {
-
+            ElementSchema.Beautify();
         }
 
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public override string GetTypeName()
         {
             return $"array<{ElementSchema.GetTypeName()}>";
         }
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             return string.Join("\n" + Tab, [

Pf2eDataScrapper/SchemaBuilder/Types/DictionarySchemaType.cs

@@ -1,23 +1,37 @@
-using System;
+using Newtonsoft.Json.Linq;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Newtonsoft.Json.Linq;
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Тип представоления словаря в схеме.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
     internal class DictionarySchemaType(SchemaNode parent) : AbstractSchemaType(parent)
     {
+        /// <summary>
+        /// Схема ключей словаря.
+        /// </summary>
         public SchemaNode KeyNode = new(parent, "[key]");
 
+        /// <summary>
+        /// Схема значений словаря.
+        /// </summary>
         public SchemaNode ItemNode = new(parent, "[value]");
 
+        /// <summary>
+        /// Проверка, что значение совместимо с текущим типом.
+        /// </summary>
+        /// <param name="value">Проверяемое значение.</param>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public override bool IsCompatibleValue(JToken value)
         {
             return Resolver.TokenType(value) == JTokenType.Object;
         }
 
+        /// <summary>
+        /// Добавление нового значения.
+        /// </summary>
+        /// <param name="value">Новое значение.</param>
         public override void AddValue(JToken value)
         {
             var obj = (JObject)value;
@@ -29,16 +43,28 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             }
         }
 
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public override void Beautify()
         {
-            
+            KeyNode.Beautify();
+            ItemNode.Beautify();
         }
 
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public override string GetTypeName()
         {
             return $"dict<{KeyNode.GetTypeName()}, {ItemNode.GetTypeName()}>";
         }
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             return string.Join("\n" + Tab, [

Pf2eDataScrapper/SchemaBuilder/Types/IgnoreSchemaType.cs

@@ -1,24 +1,42 @@
 using Newtonsoft.Json.Linq;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Тип, указывающий, что данные игнорируются.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
     internal class IgnoreSchemaType(SchemaNode parent) : AbstractSchemaType(parent)
     {
+        /// <summary>
+        /// Проверка, что значение совместимо с текущим типом.
+        /// </summary>
+        /// <param name="value">Проверяемое значение.</param>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public override bool IsCompatibleValue(JToken value)
         {
             return true;
         }
+
+        /// <summary>
+        /// Добавление нового значения.
+        /// </summary>
+        /// <param name="value">Новое значение.</param>
         public override void AddValue(JToken value)
         {
         }
+
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public override void Beautify()
         {
         }
+
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public override string GetTypeName()
         {
             return "ignore";

Pf2eDataScrapper/SchemaBuilder/Types/ObjectSchemaType.cs

@@ -1,21 +1,32 @@
 using Newtonsoft.Json.Linq;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Тип представоления объектов в схеме.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
     internal class ObjectSchemaType(SchemaNode parent) : AbstractSchemaType(parent)
     {
+        /// <summary>
+        /// Элемнты полей объекта.
+        /// </summary>
         public List<SchemaNode> Fields = [];
 
+        /// <summary>
+        /// Проверка, что значение совместимо с текущим типом.
+        /// </summary>
+        /// <param name="value">Проверяемое значение.</param>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public override bool IsCompatibleValue(JToken value)
         {
             return Resolver.TokenType(value) == JTokenType.Object;
         }
 
+        /// <summary>
+        /// Добавление нового значения.
+        /// </summary>
+        /// <param name="value">Новое значение.</param>
         public override void AddValue(JToken value)
         {
             var obj = (JObject)value;
@@ -42,6 +53,9 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             }
         }
 
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public override void Beautify()
         {
             Fields.Sort((a, b) =>
@@ -51,7 +65,7 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
                     return 1;
                 }
 
-                return a.Name.CompareTo(b.Name);
+                return string.Compare(a.Name, b.Name, StringComparison.Ordinal);
             });
 
             foreach (var field in Fields)
@@ -60,11 +74,19 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             }
         }
 
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public override string GetTypeName()
         {
             return "object";
         }
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             List<string> rows = [base.ToString()];

Pf2eDataScrapper/SchemaBuilder/Types/StaticSchemaType.cs

@@ -2,17 +2,37 @@
 
 namespace Pf2eDataScrapper.SchemaBuilder.Types
 {
+    /// <summary>
+    /// Тип представоления простых значений в схеме.
+    /// </summary>
+    /// <param name="parent">Элемент, к которому добавляется тип.</param>
+    /// <param name="type">Тип значения.</param>
     internal class StaticSchemaType(SchemaNode parent, JTokenType type) : AbstractSchemaType(parent)
     {
+        /// <summary>
+        /// Тип значения.
+        /// </summary>
         protected JTokenType Type = type;
 
+        /// <summary>
+        /// Набор возможных значений и их количества.
+        /// </summary>
         protected Dictionary<JToken, int> Values = [];
-        
+
+        /// <summary>
+        /// Проверка, что значение совместимо с текущим типом.
+        /// </summary>
+        /// <param name="value">Проверяемое значение.</param>
+        /// <returns>`true`, если значение совместимо с текущим типом.</returns>
         public override bool IsCompatibleValue(JToken value)
         {
             return value.Type == Type;
         }
 
+        /// <summary>
+        /// Добавление нового значения.
+        /// </summary>
+        /// <param name="value">Новое значение.</param>
         public override void AddValue(JToken value)
         {
             Values.TryAdd(value, 0);
@@ -20,6 +40,9 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             Values[value]++;
         }
 
+        /// <summary>
+        /// Подготовка типа к красивому представлению.
+        /// </summary>
         public override void Beautify()
         {
             if (Type == JTokenType.String)
@@ -39,11 +62,19 @@ namespace Pf2eDataScrapper.SchemaBuilder.Types
             Values = Values.OrderByDescending(pair => pair.Value).ToDictionary(pair => pair.Key, pair => pair.Value);
         }
 
+        /// <summary>
+        /// Получение строкового представоения типа элемента.
+        /// </summary>
+        /// <returns>Строковое представоение типа элемента</returns>
         public override string GetTypeName()
         {
             return Type.ToString().ToLower();
         }
 
+        /// <summary>
+        /// Полное строковое представление элемента.
+        /// </summary>
+        /// <returns>Строковое представление элемента.</returns>
         public override string ToString()
         {
             var result = base.ToString();