Реализация тестового задания (Николай Безденежных)

.gitattributes

@@ -0,0 +1 @@
+* text=auto

.gitignore

@@ -1,17 +1,9 @@
-##���������� ��� .gitignore
-#.gitignore
-
-### ���������� ���������� ��� ������
-## *.html
-###� ����� ������������� �����
-## !special.html
-### ����� ������������ ���.���������.
-## *.[ao]
-
-
-*.suo
-*.user
-.vs/
-bin/
-obj/
-packages/
+*.suo
+*.user
+.vs/
+bin/
+obj/
+packages/
+
+# Terminal Paste Image folder
+.cp-images/

README.md

@@ -1,22 +1,23 @@
 # Тестовое задание.
-Доброго дня.  
+
+Доброго дня.
 Данный репозиторий представляет из себя тестовое задание для выполнения перед собеседованием на вакансию разработчика C# в компанию Катрен.
 
-Репозиторий уже содержит основные классы и методы для последующей разработки.  
-Большая часть уже описаных методов - _заглушки_, требующие реализации.  
+Репозиторий уже содержит основные классы и методы для последующей разработки.
+Большая часть уже описаных методов - _заглушки_, требующие реализации.
 
-Все методы/классы документированы и описывают своё предназначение и требуемое поведение.  
-Таким образом, чтобы понять что именно данный метод должен делать - достаточно внимательно прочитать его документацию.  
+Все методы/классы документированы и описывают своё предназначение и требуемое поведение.
+Таким образом, чтобы понять что именно данный метод должен делать - достаточно внимательно прочитать его документацию.
 
-Все места, требующие реализации, помечены _TODO_ маркером. Всего таких мест 9 шт.  
-Все _TODO_ маркеры можно найти нажатием _"Ctrl+W, T"_ (Visual Studio 2017) или любым другим удобным для Вас способом.  
+Все места, требующие реализации, помечены _TODO_ маркером. Всего таких мест 9 шт.
+Все _TODO_ маркеры можно найти нажатием _"Ctrl+W, T"_ (Visual Studio 2017) или любым другим удобным для Вас способом.
 
-Исходный код содержит ошибки/недоработки, которые необходимо исправить каким-либо способом процессе разработки.   
+Исходный код содержит ошибки/недоработки, которые необходимо исправить каким-либо способом процессе разработки.
 
-В рамках разработки не запрещается как-либо модифицировать уже существующий код.  
-А именно допускается: создание/удаление/модификация  методов/классов/структур и т.д., если этого требует ваша реализация.   
+В рамках разработки не запрещается как-либо модифицировать уже существующий код.
+А именно допускается: создание/удаление/модификация методов/классов/структур и т.д., если этого требует ваша реализация.
 
-__Для разработки настоятельно рекомендуется сделать Fork данного проекта.  
-И по готовности результат отдать на ревью методом Pull Request'a.__  
+**Для разработки настоятельно рекомендуется сделать Fork данного проекта.
+И по готовности результат отдать на ревью методом Pull Request'a.**
 
-Если данный способ по каким-то причинам Вам не представляется реализуемым, можете выслать результат в виде архива на почту кадровому агенту.  
+Если данный способ по каким-то причинам Вам не представляется реализуемым, можете выслать результат в виде архива на почту кадровому агенту.

TestTask/LetterStats.cs → TestTask/CharStats.cs

@@ -1,18 +1,18 @@
-namespace TestTask
-{
-    /// <summary>
-    /// Статистика вхождения буквы/пары букв
-    /// </summary>
-    public struct LetterStats
-    {
-        /// <summary>
-        /// Буква/Пара букв для учёта статистики.
-        /// </summary>
-        public string Letter;
-
-        /// <summary>
-        /// Кол-во вхождений буквы/пары.
-        /// </summary>
-        public int Count;
-    }
-}
+namespace TestTask
+{
+    /// <summary>
+    /// Статистика вхождения буквы/пары букв
+    /// </summary>
+    public class CharStats
+    {
+        /// <summary>
+        /// Буква/Пара букв для учёта статистики.
+        /// </summary>
+        public string Char;
+
+        /// <summary>
+        /// Кол-во вхождений буквы/пары.
+        /// </summary>
+        public int Count;
+    }
+}

TestTask/CharType.cs

@@ -1,18 +1,30 @@
-namespace TestTask
-{
-    /// <summary>
-    /// Тип букв
-    /// </summary>
-    public enum CharType
-    {
-        /// <summary>
-        /// Гласные
-        /// </summary>
-        Vowel,
-
-        /// <summary>
-        /// Согласные
-        /// </summary>
-        Consonants
-    }
-}
+namespace TestTask
+{
+    /// <summary>
+    /// Тип букв
+    /// </summary>
+    public enum CharType
+    {
+        /// <summary>
+        /// Гласные
+        /// </summary>
+        Vowel,
+
+        /// <summary>
+        /// Согласные
+        /// </summary>
+        Consonants
+    }
+
+    /// <summary>
+    /// Вспомогательный класс для классификации букв по типу.
+    /// </summary>
+    public static class CharTypeHelper
+    {
+        private const string RussianVowels = "аеёиоуыэюя";
+        // TODO: добавить латинские гласные при необходимости: "aeiou"
+
+        public static bool IsVowel(char c) =>
+            RussianVowels.Contains(char.ToLower(c));
+    }
+}

TestTask/IReadOnlyStream.cs

@@ -1,16 +1,17 @@
-namespace TestTask
-{
-    /// <summary>
-    /// Интерфейс для работы с файлом в сильно урезаном виде.
-    /// Умеет всего 2 вещи: прочитать символ, и перемотать стрим на начало.
-    /// </summary>
-    internal interface IReadOnlyStream
-    {
-        // TODO : Необходимо доработать данный интерфейс для обеспечения гарантированного закрытия файла, по окончанию работы с таковым!
-        char ReadNextChar();
-
-        void ResetPositionToStart();
-
-        bool IsEof { get; }
-    }
-}
+using System;
+
+namespace TestTask
+{
+    /// <summary>
+    /// Интерфейс для работы с файлом в сильно урезаном виде.
+    /// Умеет всего 2 вещи: прочитать символ, и перемотать стрим на начало.
+    /// </summary>
+    internal interface IReadOnlyStream : IDisposable
+    {
+        char ReadNextChar();
+
+        void ResetPositionToStart();
+
+        bool IsEof { get; }
+    }
+}