20230514

2023-05-14 18:29:41 +03:00
parent ff965f08bd
commit ef329af61a
13 changed files with 455 additions and 95 deletions
--- a/anbs_cp/Classes/FileExtensions.cs
+++ b/anbs_cp/Classes/FileExtensions.cs
@@ -1,8 +1,4 @@
-using System.Security.Cryptography;
-
-using Microsoft.AspNetCore.Http;
-
-namespace anbs_cp.Classes;
+namespace anbs_cp.Classes;

 /// <summary>
 /// Класс -- расширение для класса File
@@ -17,14 +13,6 @@ public static class FileExtension
    public static string MIMEType (string filename) =>
        MimeTypes.GetMimeType(filename);

-    /// <summary>
-    /// Получает MIME-тип файла
-    /// </summary>
-    /// <param name="file">Загружаемый файл</param>
-    /// <returns>MIME-тип файла</returns>
-    public static string MIMEType (IFormFile file) =>
-        file.ContentType;
-
    /// <summary>
    /// Размер файла в байтах
    /// </summary>
--- a/anbs_cp/Classes/FileHash.cs
+++ b/anbs_cp/Classes/FileHash.cs
@@ -1,8 +1,6 @@
 using System.Security.Cryptography;
 using System.Text;

-using Microsoft.AspNetCore.Http;
-
 namespace anbs_cp.Classes;

 /// <summary>
@@ -23,19 +21,6 @@ public sealed class FileHash
        Hash = md5.ComputeHash(stream);
    }

-    /// <summary>
-    /// Получение md5-хэша загружаемого файла.
-    /// Взято с https://stackoverflow.com/a/67081012/16469671
-    /// </summary>
-    /// <param name="file">Загружаемый файл</param>
-    /// <returns>Массив хэша</returns>
-    public FileHash (IFormFile file)
-    {
-        using MD5 md5 = MD5.Create();
-        using StreamReader streamReader = new(file.OpenReadStream());
-        Hash = md5.ComputeHash(streamReader.BaseStream);
-    }
-
    /// <summary>
    /// Простой конструктор
    /// </summary>
--- a/anbs_cp/Classes/PasswordOptions.cs
+++ b/anbs_cp/Classes/PasswordOptions.cs
@@ -0,0 +1,50 @@
+namespace anbs_cp.Classes;
+
+/// <summary>
+/// Параметры пароля
+/// </summary>
+public sealed class PasswordOptions
+{
+    /// <summary>
+    /// Конструктор
+    /// </summary>
+    public PasswordOptions ()
+    {
+        RequiredLength = 8;
+        RequireLowercase = true;
+        RequireUppercase = true;
+        RequireDigit = true;
+        RequireNonAlphanumeric = false;
+        RequiredUniqueChars = 6;
+    }
+
+    /// <summary>
+    /// Требуемая длина пароля
+    /// </summary>
+    public byte RequiredLength { get; set; }
+
+    /// <summary>
+    /// Требовать строчные буквы в пароле
+    /// </summary>
+    public bool RequireLowercase { get; set; }
+
+    /// <summary>
+    /// Требовать прописные буквы в пароле
+    /// </summary>
+    public bool RequireUppercase { get; set; }
+
+    /// <summary>
+    /// Требовать цифры в пароле
+    /// </summary>
+    public bool RequireDigit { get; set; }
+
+    /// <summary>
+    /// Требовать символы
+    /// </summary>
+    public bool RequireNonAlphanumeric { get; set; }
+
+    /// <summary>
+    /// Уникальных символов
+    /// </summary>
+    public byte RequiredUniqueChars { get; set; }
+}
--- a/anbs_cp/Classes/TextFormatter.cs
+++ b/anbs_cp/Classes/TextFormatter.cs
@@ -0,0 +1,111 @@
+using System.Net.Mail;
+
+namespace anbs_cp.Classes;
+
+/// <summary>
+/// Форматирование текста
+/// </summary>
+public static class TextFormatter
+{
+    /// <summary>
+    /// Заменяет %МАРКЕРЫ% на их значения
+    /// </summary>
+    /// <param name="message">Текст сообщения</param>
+    /// <param name="replaceDictionary">Словарь замен</param>
+    /// <returns>Отформатированное сообщение</returns>
+    public static string FormatMessage (string message, Dictionary<string, string> replaceDictionary) =>
+        replaceDictionary.Aggregate(message,
+            static (current, item) => current.Replace($"%{item.Key}%", item.Value));
+
+    /// <summary>
+    /// Обрезает строку до указанных в параметре <paramref name="maxLength"/> символов
+    /// </summary>
+    /// <param name="text">Текст, который нужно обрезать</param>
+    /// <param name="maxLength">Максимальное количество символов в тексте</param>
+    /// <param name="endDots">Чем завершать обрезанный текст, если он был обрезан. Внимание расходует <see cref="maxLength"/>!</param>
+    /// <returns>Обрезанный текст</returns>
+    public static string GetShortText (string text, int maxLength, string endDots = "") =>
+        text.Length < maxLength ? text : $"{text[..(maxLength - endDots.Length)]}{endDots}";
+
+    /// <summary>
+    /// Генерирует случайный пароль, удовлетворяющий параметрам <see cref="PasswordOptions"/> <paramref name="options"/>.
+    /// Автор метода: Darkseal (https://stackoverflow.com/users/1233379/darkseal)
+    /// URL: https://stackoverflow.com/a/46229180/16469671
+    /// </summary>
+    /// <param name="options">Объект допустимых параметров пароля, содержащий требования к надежности пароля.</param>
+    /// <returns>Случайный пароль</returns>
+    public static string GenerateRandomPassword (PasswordOptions? options)
+    {
+        //Проверка options и установка по-умолчанию
+        options ??= new();
+
+        //Получаю массив символов
+        string[] randomChars = {
+            "ABCDEFGHJKLMNOPQRSTUVWXYZ",    // прописные буквы
+            "abcdefghijkmnopqrstuvwxyz",    // строчные буквы
+            "0123456789",                   // цифры
+            "~!@#$%^&*+-/.,{}[]();:|?<>='`" // символы
+        };
+
+        //Создаю объект Random
+        Random rand = new(Environment.TickCount);
+
+        //Массив результатов
+        List<char> chars = new();
+
+        //Вставляю прописные буквы
+        if (options.RequireUppercase)
+            chars.Insert(rand.Next(0, chars.Count),
+                randomChars[0][rand.Next(0, randomChars[0].Length)]);
+
+        //Вставляю строчные буквы
+        if (options.RequireLowercase)
+            chars.Insert(rand.Next(0, chars.Count),
+                randomChars[1][rand.Next(0, randomChars[1].Length)]);
+
+        //Вставляю цифры
+        if (options.RequireDigit)
+            chars.Insert(rand.Next(0, chars.Count),
+                randomChars[2][rand.Next(0, randomChars[2].Length)]);
+
+        //Вставляю символы
+        if (options.RequireNonAlphanumeric)
+            chars.Insert(rand.Next(0, chars.Count),
+                randomChars[3][rand.Next(0, randomChars[3].Length)]);
+
+        //Делаю выборку
+        for (int i = chars.Count; i < options.RequiredLength || chars.Distinct().Count() < options.RequiredUniqueChars; i++)
+        {
+            string rcs = randomChars[rand.Next(0, randomChars.Length)];
+            chars.Insert(rand.Next(0, chars.Count),
+                rcs[rand.Next(0, rcs.Length)]);
+        }
+
+        //Вывожу результат
+        return new(chars.ToArray());
+    }
+
+    /// <summary>
+    /// Проверяет <paramref name="email"/> на соответствие критерию электронной почты
+    /// Взято с: https://stackoverflow.com/a/1374644/16469671
+    /// </summary>
+    /// <param name="email">Проверяемая строка</param>
+    /// <returns>Является ли <paramref name="email"/> адресом электронной почты</returns>
+    public static bool IsValidEmail (string email)
+    {
+        string trimmedEmail = email.Trim();
+
+        if (trimmedEmail.EndsWith(".", StringComparison.Ordinal))
+            return false;
+
+        try
+        {
+            MailAddress addr = new(email);
+            return addr.Address == trimmedEmail;
+        }
+        catch
+        {
+            return false;
+        }
+    }
+}
--- a/anbs_cp/Classes/TypeConverter.cs
+++ b/anbs_cp/Classes/TypeConverter.cs
@@ -1,7 +1,4 @@
-using System.Text.Encodings.Web;
-using Microsoft.AspNetCore.Html;
-
-namespace anbs_cp.Classes;
+namespace anbs_cp.Classes;

 /// <summary>
 ///     Конвертер типов на манер Delphi
@@ -13,37 +10,37 @@ public static class TypeConverter
    /// <summary>
    ///     Преобразование int в string
    /// </summary>
-    /// <param name="AInt">Число</param>
+    /// <param name="aInt">Число</param>
    /// <returns>Строка</returns>
-    public static string IntToStr(int AInt) => AInt.ToString();
+    public static string IntToStr (int aInt) => aInt.ToString();

    /// <summary>
    ///     Преобразование uint в string
    /// </summary>
-    /// <param name="AInt">Число</param>
+    /// <param name="aInt">Число</param>
    /// <returns>Строка</returns>
-    public static string IntToStr(uint AInt) => AInt.ToString();
+    public static string IntToStr (uint aInt) => aInt.ToString();

    /// <summary>
    ///     Преобразование long в string
    /// </summary>
-    /// <param name="AInt">Число</param>
+    /// <param name="aInt">Число</param>
    /// <returns>Строка</returns>
-    public static string IntToStr(long AInt) => AInt.ToString();
+    public static string IntToStr (long aInt) => aInt.ToString();

    /// <summary>
    ///     Преобразование ulong в string
    /// </summary>
-    /// <param name="AInt">Число</param>
+    /// <param name="aInt">Число</param>
    /// <returns>Строка</returns>
-    public static string IntToStr(ulong AInt) => AInt.ToString();
+    public static string IntToStr (ulong aInt) => aInt.ToString();

    /// <summary>
    ///     Преобразование byte в string
    /// </summary>
-    /// <param name="AInt">Число</param>
+    /// <param name="aInt">Число</param>
    /// <returns>Строка</returns>
-    public static string IntToStr(byte AInt) => AInt.ToString();
+    public static string IntToStr (byte aInt) => aInt.ToString();

    #endregion

@@ -52,86 +49,67 @@ public static class TypeConverter
    /// <summary>
    ///     Преобразование строки в число
    /// </summary>
-    /// <param name="AStr">Строка</param>
-    /// <param name="ADefault">Значение по умолчанию (по умолчанию, 0)</param>
+    /// <param name="aStr">Строка</param>
+    /// <param name="aDefault">Значение по умолчанию (по умолчанию, 0)</param>
    /// <returns>Число</returns>
-    public static int StrToInt(string AStr, int ADefault = 0)
+    public static int StrToInt (string aStr, int aDefault = 0)
    {
-        if (!int.TryParse(AStr, out int result)) result = ADefault;
+        if (!int.TryParse(aStr, out int result))
+            result = aDefault;
        return result;
    }

    /// <summary>
    ///     Преобразование строки в число
    /// </summary>
-    /// <param name="AStr">Строка</param>
-    /// <param name="ADefault">Значение по умолчанию (по умолчанию, 0)</param>
+    /// <param name="aStr">Строка</param>
+    /// <param name="aDefault">Значение по умолчанию (по умолчанию, 0)</param>
    /// <returns>Число</returns>
-    public static uint StrToUInt(string AStr, uint ADefault = 0)
+    public static uint StrToUInt (string aStr, uint aDefault = 0)
    {
-        if (!uint.TryParse(AStr, out uint result)) result = ADefault;
+        if (!uint.TryParse(aStr, out uint result))
+            result = aDefault;
        return result;
    }

    /// <summary>
    ///     Преобразование строки в число
    /// </summary>
-    /// <param name="AStr">Строка</param>
-    /// <param name="ADefault">Значение по умолчанию (по умолчанию, 0)</param>
+    /// <param name="aStr">Строка</param>
+    /// <param name="aDefault">Значение по умолчанию (по умолчанию, 0)</param>
    /// <returns>Число</returns>
-    public static long StrToInt64(string AStr, long ADefault = 0)
+    public static long StrToInt64 (string aStr, long aDefault = 0)
    {
-        if (!long.TryParse(AStr, out long result)) result = ADefault;
+        if (!long.TryParse(aStr, out long result))
+            result = aDefault;
        return result;
    }

    /// <summary>
    ///     Преобразование строки в число
    /// </summary>
-    /// <param name="AStr">Строка</param>
-    /// <param name="ADefault">Значение по умолчанию (по умолчанию, 0)</param>
+    /// <param name="aStr">Строка</param>
+    /// <param name="aDefault">Значение по умолчанию (по умолчанию, 0)</param>
    /// <returns>Число</returns>
-    public static ulong StrToUInt64(string AStr, ulong ADefault = 0)
+    public static ulong StrToUInt64 (string aStr, ulong aDefault = 0)
    {
-        if (!ulong.TryParse(AStr, out ulong result)) result = ADefault;
+        if (!ulong.TryParse(aStr, out ulong result))
+            result = aDefault;
        return result;
    }

    /// <summary>
    ///     Преобразование строки в число
    /// </summary>
-    /// <param name="AStr">Строка</param>
-    /// <param name="ADefault">Значение по умолчанию (по умолчанию, 0)</param>
+    /// <param name="aStr">Строка</param>
+    /// <param name="aDefault">Значение по умолчанию (по умолчанию, 0)</param>
    /// <returns>Число</returns>
-    public static byte StrToByte(string AStr, byte ADefault = 0)
+    public static byte StrToByte (string aStr, byte aDefault = 0)
    {
-        if (!byte.TryParse(AStr, out byte result)) result = ADefault;
+        if (!byte.TryParse(aStr, out byte result))
+            result = aDefault;
        return result;
    }

    #endregion
-
-    #region Конвернтация IHtmlContent
-    /// <summary>
-    /// Преобразует тип <see cref="IHtmlContent"/> в строку <see cref="string"/>.
-    /// </summary>
-    /// <param name="content">Значение, которое нужно преобразовать.</param>
-    /// <returns><see cref="string"/></returns>
-    public static string HtmlContentToString(IHtmlContent content)
-    {
-        //Создаём writer
-        using StringWriter writer = new();
-        //Конвертируем IHtmlContent в string
-        content.WriteTo(writer, HtmlEncoder.Default);
-        //Возвращаем результат
-        return writer.ToString();
-    }
-
-    /// <summary>
-    /// Преобразует строку <see cref="string"/> в тип <see cref="IHtmlContent"/>.
-    /// </summary>
-    /// <param name="content">Значение, которое нужно преобразовать.</param>
-    /// <returns><see cref="IHtmlContent"/></returns>
-    public static IHtmlContent StringToHtmlContent(string content) => new HtmlContentBuilder().AppendHtml(content);
-    #endregion
 }
--- a/anbs_cp/anbs_cp.csproj
+++ b/anbs_cp/anbs_cp.csproj
@@ -2,11 +2,11 @@

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
-    <Version>2023.409.2</Version>
-    <Authors>Alexander Babaev</Authors>
-    <Product>ANB Software Components Pack</Product>
-    <Description>Library of some useful functions in C# language.</Description>
-    <Copyright>Alexander Babaev</Copyright>
+    <Version>2023.0514.2</Version>
+    <Authors>Александр Бабаев</Authors>
+    <Product>Набор компонентов ANB Software</Product>
+    <Description>Библиотека полезных методов языка C#</Description>
+    <Copyright>Александр Бабаев</Copyright>
    <AssemblyName>anbs_cp</AssemblyName>
    <RootNamespace>anbs_cp</RootNamespace>
    <Nullable>enable</Nullable>
@@ -38,10 +38,8 @@

  <ItemGroup>
    <PackageReference Include="gfoidl.Base64" Version="2.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Html.Abstractions" Version="2.2.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Http.Features" Version="5.0.17" />
    <PackageReference Include="Microsoft.VisualStudio.Shell.Interop" Version="17.5.33428.366" />
-    <PackageReference Include="Microsoft.Windows.Compatibility" Version="7.0.0" />
+    <PackageReference Include="Microsoft.Windows.Compatibility" Version="7.0.1" />
    <PackageReference Include="MimeTypes" Version="2.4.1">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>