babaev-an/anb_python_components
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

20251004-1

Browse Source
This commit is contained in:
Александр Бабаев
2025-10-04 18:22:18 +03:00
parent 2d0a800598
commit 4cbb69181c
10 changed files with 247 additions and 237 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
anb_python_components/enums/not_bool_action.py
View File

@@ -2,7 +2,6 @@
from enum import Enum from enum import Enum
class NotBoolAction(Enum): class NotBoolAction(Enum):
""" """
Перечисление типов действий, которые необходимо выполнить, если переменная не является булевым типом. Перечисление типов действий, которые необходимо выполнить, если переменная не является булевым типом.

2
anb_python_components/exceptions/wrong_type_exception.py
View File

@@ -5,7 +5,7 @@ class WrongTypeException(Exception):
Ошибка, возникающая при попытке присвоить значение другого типа данным полям. Ошибка, возникающая при попытке присвоить значение другого типа данным полям.
""" """
def __init__(self, message: str = None, type_name: str = None, real_type_name: str = None, var_name: str = None): def __init__ (self, message: str = None, type_name: str = None, real_type_name: str = None, var_name: str = None):
""" """
Инициализация экземпляра класса WrongTypeException. Инициализация экземпляра класса WrongTypeException.
:param message: Сообщение об ошибке. :param message: Сообщение об ошибке.

5
anb_python_components/extensions/array_extension.py
View File

@@ -2,20 +2,19 @@
from anb_python_components.extensions.string_extension import StringExtension from anb_python_components.extensions.string_extension import StringExtension
class ArrayExtension: class ArrayExtension:
""" """
Класс расширения для работы с массивами. Класс расширения для работы с массивами.
""" """
def __init__(self): def __init__ (self):
""" """
Инициализация расширения. Инициализация расширения.
""" """
pass pass
@staticmethod @staticmethod
def remove_empties(array: list[str], re_sort: bool = False) -> list[str]: def remove_empties (array: list[str], re_sort: bool = False) -> list[str]:
""" """
Удаляет пустые строки из массива. Удаляет пустые строки из массива.

9
anb_python_components/extensions/bool_extension.py
View File

@@ -2,20 +2,19 @@
from anb_python_components.enums.not_bool_action import NotBoolAction from anb_python_components.enums.not_bool_action import NotBoolAction
class BoolExtension: class BoolExtension:
""" """
Расширение типа "правда/ложь". Расширение типа "правда/ложь".
""" """
def __init__(self): def __init__ (self):
""" """
Инициализация расширения. Инициализация расширения.
""" """
pass pass
@staticmethod @staticmethod
def to_str(b: bool, if_true: str = "True", if_false: str = "False") -> str: def to_str (b: bool, if_true: str = "True", if_false: str = "False") -> str:
""" """
Конвертирует булево значение в строку. Конвертирует булево значение в строку.
:param b: Булево значение. :param b: Булево значение.
@@ -26,7 +25,7 @@ class BoolExtension:
return if_true if b else if_false return if_true if b else if_false
@staticmethod @staticmethod
def true_count(expressions: list[bool], if_not_bool: NotBoolAction = NotBoolAction.IGNORE) -> int: def true_count (expressions: list[bool], if_not_bool: NotBoolAction = NotBoolAction.IGNORE) -> int:
""" """
Возвращает количество истинных значений в списке аргументов. Возвращает количество истинных значений в списке аргументов.
:param expressions: Список аргументов. :param expressions: Список аргументов.
@@ -75,7 +74,7 @@ class BoolExtension:
return len(filtered) return len(filtered)
@staticmethod @staticmethod
def any_true(expressions: list[bool]) -> bool: def any_true (expressions: list[bool]) -> bool:
""" """
Проверяет, есть ли хотя бы один истинный аргумент. Проверяет, есть ли хотя бы один истинный аргумент.
:param expressions: Выражения. :param expressions: Выражения.

51
anb_python_components/extensions/guid_extension.py
View File

@@ -1,23 +1,22 @@
# anb_python_components/extensions/guid_extension.py # anb_python_components/extensions/guid_extension.py
import secrets import secrets
from anb_python_components.classes.guid import GUID, GUID_EMPTY
from anb_python_components.exceptions.wrong_type_exception import WrongTypeException from anb_python_components.exceptions.wrong_type_exception import WrongTypeException
from anb_python_components.types.guid import GUID
class GUIDExtension: class GUIDExtension:
""" """
Класс GUIDExtension реализует расширение для работы с GUID. Класс GUIDExtension реализует расширение для работы с GUID.
""" """
def __init__(self): def __init__ (self):
""" """
Инициализация расширения. Инициализация расширения.
""" """
pass pass
@staticmethod @staticmethod
def generate() -> GUID: def generate () -> GUID:
""" """
Генерирует уникальный идентификатор GUID согласно стандарту RFC 4122. Генерирует уникальный идентификатор GUID согласно стандарту RFC 4122.
""" """
@@ -30,37 +29,39 @@ class GUIDExtension:
# Объединение компонентов в единый GUID # Объединение компонентов в единый GUID
guid_parts = [ guid_parts = [
time_low >> 16, time_low & 0xffff, time_low >> 16, time_low & 0xffff,
time_mid, time_mid,
time_hi_and_version, time_hi_and_version,
clock_seq_hi_and_reserved, clock_seq_hi_and_reserved,
node_id >> 32, (node_id >> 16) & 0xffff, node_id & 0xffff node_id >> 32, (node_id >> 16) & 0xffff, node_id & 0xffff
] ]
# Форматируем компоненты в виде строки GUID # Форматируем компоненты в виде строки GUID
guid_str = "-".join([ guid_str = "-".join(
"%08x" % guid_parts[0], [
"%04x" % guid_parts[1], "%08x" % guid_parts[0],
"%04x" % guid_parts[2], "%04x" % guid_parts[1],
"%04x" % guid_parts[3], "%04x" % guid_parts[2],
("%04x%04x%04x" % tuple(guid_parts[4:])), "%04x" % guid_parts[3],
]) ("%04x%04x%04x" % tuple(guid_parts[4:])),
]
)
# Возвращаем экземпляр GUID # Возвращаем экземпляр GUID
return GUID(guid_str) return GUID(guid_str)
@staticmethod @staticmethod
def is_equal(guid1: str | GUID, guid2: str | GUID) -> bool: def is_equal (guid1: str | GUID, guid2: str | GUID) -> bool:
# Если guid1 не является GUID или строкой # Если guid1 не является GUID или строкой
if not isinstance(guid1, GUID) or not isinstance(guid1, str): if not isinstance(guid1, GUID) or not isinstance(guid1, str):
# - генерируем исключение # - генерируем исключение
raise WrongTypeException("Неверный тип аргумента!", "GUID|str", var_name="guid1") raise WrongTypeException("Неверный тип аргумента!", "GUID|str", var_name = "guid1")
# Если guid2 не является GUID или строкой # Если guid2 не является GUID или строкой
if not isinstance(guid2, GUID) or not isinstance(guid2, str): if not isinstance(guid2, GUID) or not isinstance(guid2, str):
# - генерируем исключение # - генерируем исключение
raise WrongTypeException("Неверный тип аргумента!", "GUID|str", var_name="guid2") raise WrongTypeException("Неверный тип аргумента!", "GUID|str", var_name = "guid2")
# Если guid1 является строкой # Если guid1 является строкой
if not isinstance(guid1, GUID): if not isinstance(guid1, GUID):
@@ -76,7 +77,7 @@ class GUIDExtension:
return guid1 == guid2 return guid1 == guid2
@staticmethod @staticmethod
def validate(guid: str | GUID) -> bool: def validate (guid: str | GUID) -> bool:
""" """
Проверка GUID на валидность. Проверка GUID на валидность.
:param guid: GUID для проверки. :param guid: GUID для проверки.
@@ -89,7 +90,7 @@ class GUIDExtension:
return bool(GUID.validate_str(guid)) return bool(GUID.validate_str(guid))
@staticmethod @staticmethod
def is_invalid_or_empty(guid: str | GUID) -> bool: def is_invalid_or_empty (guid: str | GUID) -> bool:
""" """
Проверка GUID на валидность и не пустоту. Проверка GUID на валидность и не пустоту.
:param guid: Класс или строка GUID для проверки. :param guid: Класс или строка GUID для проверки.
@@ -99,10 +100,10 @@ class GUIDExtension:
guid = guid if isinstance(guid, str) else str(guid) guid = guid if isinstance(guid, str) else str(guid)
# Проверяем GUID # Проверяем GUID
return not GUID.validate_str(guid) or guid == GUID_EMPTY return not GUID.validate_str(guid) or GUID(guid) == GUID(GUID.EMPTY)
@classmethod @classmethod
def parse(cls, guid_string: str, empty_if_not_valid: bool = True) -> GUID: def parse (cls, guid_string: str, empty_if_not_valid: bool = True) -> GUID:
""" """
Парсинг GUID из строки. Парсинг GUID из строки.
:param guid_string: Строка GUID. :param guid_string: Строка GUID.
@@ -117,7 +118,7 @@ class GUIDExtension:
# Если же GUID недействителен и запрещено выбрасывать исключение # Если же GUID недействителен и запрещено выбрасывать исключение
if empty_if_not_valid: if empty_if_not_valid:
# -- то возвращаем пустой GUID # -- то возвращаем пустой GUID
return GUID(GUID_EMPTY) return GUID(GUID.EMPTY)
else: else:
# -- иначе выбрасываем исключение # -- иначе выбрасываем исключение
raise WrongTypeException('Предан неверный GUID / Wrong GUID.') raise WrongTypeException('Предан неверный GUID / Wrong GUID.')

25
anb_python_components/extensions/string_extension.py
View File

@@ -3,20 +3,19 @@ import re
from .string_extension_constant import StringExtensionConstants from .string_extension_constant import StringExtensionConstants
class StringExtension: class StringExtension:
""" """
Расширение строк. Расширение строк.
""" """
def __init__(self): def __init__ (self):
""" """
Конструктор. Конструктор.
""" """
pass pass
@staticmethod @staticmethod
def is_none_or_empty(text: str | None) -> bool: def is_none_or_empty (text: str | None) -> bool:
""" """
Проверяет, пуста ли строка. Проверяет, пуста ли строка.
:param text: Проверяемая строка. :param text: Проверяемая строка.
@@ -25,7 +24,7 @@ class StringExtension:
return text is None or text == "" return text is None or text == ""
@classmethod @classmethod
def is_none_or_whitespace(cls, text: str | None) -> bool: def is_none_or_whitespace (cls, text: str | None) -> bool:
""" """
Проверяет, пуста ли строка, содержит ли вместо текста только пробелы. Проверяет, пуста ли строка, содержит ли вместо текста только пробелы.
:param text: Проверяемая строка. :param text: Проверяемая строка.
@@ -34,7 +33,7 @@ class StringExtension:
return cls.is_none_or_empty(text) or text.strip() == '' return cls.is_none_or_empty(text) or text.strip() == ''
@staticmethod @staticmethod
def is_russian_letter(letter: str) -> bool: def is_russian_letter (letter: str) -> bool:
""" """
Проверяет, является ли символ русским буквой. Проверяет, является ли символ русским буквой.
:param letter: Проверяемый символ. :param letter: Проверяемый символ.
@@ -44,7 +43,7 @@ class StringExtension:
return letter in StringExtensionConstants.russian_letters return letter in StringExtensionConstants.russian_letters
@staticmethod @staticmethod
def get_russian_letter_transliteration(letter: str) -> bool | None: def get_russian_letter_transliteration (letter: str) -> bool | None:
""" """
Получаю транслитерированную букву русского алфавита. Получаю транслитерированную букву русского алфавита.
:param letter: Буква русского алфавита. :param letter: Буква русского алфавита.
@@ -67,7 +66,7 @@ class StringExtension:
return transliteration return transliteration
@classmethod @classmethod
def convert_to_latin(cls, source: str) -> str: def convert_to_latin (cls, source: str) -> str:
""" """
Конвертация в латиницу. Конвертация в латиницу.
:param source: Исходная строка. :param source: Исходная строка.
@@ -97,7 +96,7 @@ class StringExtension:
return result return result
@classmethod @classmethod
def compare(cls, str1: str | None, str2: str | None, ignore_case: bool = False) -> int: def compare (cls, str1: str | None, str2: str | None, ignore_case: bool = False) -> int:
""" """
Сравнивает две строки. Сравнивает две строки.
:param str1: Первая строка. :param str1: Первая строка.
@@ -142,7 +141,7 @@ class StringExtension:
return 1 if len1 >= len2 else -1 return 1 if len1 >= len2 else -1
@staticmethod @staticmethod
def get_short_text(text: str, max_length: int, end_symbols: str = '') -> str: def get_short_text (text: str, max_length: int, end_symbols: str = '') -> str:
""" """
Обрезает строку до указанных в параметре max_length символов. Обрезает строку до указанных в параметре max_length символов.
:param text: Исходный текст. :param text: Исходный текст.
@@ -162,7 +161,7 @@ class StringExtension:
return text[:len_no_end_symbols] + end_symbols return text[:len_no_end_symbols] + end_symbols
@staticmethod @staticmethod
def to_utf8(subject: str, encoding: str = 'UTF-8') -> str: def to_utf8 (subject: str, encoding: str = 'UTF-8') -> str:
""" """
Перекодирует строку в UTF-8. Перекодирует строку в UTF-8.
:param subject: Исходная строка. :param subject: Исходная строка.
@@ -187,7 +186,7 @@ class StringExtension:
return utf8_bytes.decode('UTF-8') return utf8_bytes.decode('UTF-8')
@staticmethod @staticmethod
def from_utf8(subject: str, to_encoding: str = 'UTF-8') -> str: def from_utf8 (subject: str, to_encoding: str = 'UTF-8') -> str:
""" """
Перекодирует строку из UTF-8. Перекодирует строку из UTF-8.
:param subject: Исходная строка. :param subject: Исходная строка.
@@ -206,7 +205,7 @@ class StringExtension:
return str(target_bytes.decode('UTF-8').encode(to_encoding)) return str(target_bytes.decode('UTF-8').encode(to_encoding))
@classmethod @classmethod
def replace(cls, subject: str, search: str, replace: str, encoding: str = 'UTF-8') -> str: def replace (cls, subject: str, search: str, replace: str, encoding: str = 'UTF-8') -> str:
""" """
Заменяет в строке все вхождения строки поиска на строку замены. Заменяет в строке все вхождения строки поиска на строку замены.
:param subject: Исходная строка. :param subject: Исходная строка.
@@ -239,7 +238,7 @@ class StringExtension:
return result return result
@classmethod @classmethod
def replace_all(cls, search_replace: dict[str, str], subject: str, encoding: str = 'UTF-8') -> str: def replace_all (cls, search_replace: dict[str, str], subject: str, encoding: str = 'UTF-8') -> str:
""" """
Заменяет в строке все вхождения строки поиска на строку замены. Заменяет в строке все вхождения строки поиска на строку замены.
:param search_replace: Словарь с парами поиска и замены. Например, {'-': '#', '$': '%'} :param search_replace: Словарь с парами поиска и замены. Например, {'-': '#', '$': '%'}

134
anb_python_components/extensions/string_extension_constant.py
View File

@@ -11,70 +11,70 @@ class StringExtensionConstants:
# Словарь соответствия русских букв в транслитерации # Словарь соответствия русских букв в транслитерации
russian_letters = { russian_letters = {
'а': 'a', 'а': 'a',
'б': 'b', 'б': 'b',
'в': 'v', 'в': 'v',
'г': 'g', 'г': 'g',
'д': 'd', 'д': 'd',
'е': 'e', 'е': 'e',
'ё': 'yo', 'ё': 'yo',
'ж': 'zh', 'ж': 'zh',
'з': 'z', 'з': 'z',
'и': 'i', 'и': 'i',
'й': 'j', 'й': 'j',
'к': 'k', 'к': 'k',
'л': 'l', 'л': 'l',
'м': 'm', 'м': 'm',
'н': 'n', 'н': 'n',
'о': 'o', 'о': 'o',
'п': 'p', 'п': 'p',
'р': 'r', 'р': 'r',
'с': 's', 'с': 's',
'т': 't', 'т': 't',
'у': 'u', 'у': 'u',
'ф': 'f', 'ф': 'f',
'х': 'h', 'х': 'h',
'ц': 'c', 'ц': 'c',
'ч': 'ch', 'ч': 'ch',
'ш': 'sh', 'ш': 'sh',
'щ': 'sch', 'щ': 'sch',
'ъ': 'j', 'ъ': 'j',
'ы': 'i', 'ы': 'i',
'ь': 'j', 'ь': 'j',
'э': 'e', 'э': 'e',
'ю': 'yu', 'ю': 'yu',
'я': 'ya', 'я': 'ya',
'А': 'A', 'А': 'A',
'Б': 'B', 'Б': 'B',
'В': 'V', 'В': 'V',
'Г': 'G', 'Г': 'G',
'Д': 'D', 'Д': 'D',
'Е': 'E', 'Е': 'E',
'Ё': 'Yo', 'Ё': 'Yo',
'Ж': 'Zh', 'Ж': 'Zh',
'З': 'Z', 'З': 'Z',
'И': 'I', 'И': 'I',
'Й': 'J', 'Й': 'J',
'К': 'K', 'К': 'K',
'Л': 'L', 'Л': 'L',
'М': 'M', 'М': 'M',
'Н': 'N', 'Н': 'N',
'О': 'O', 'О': 'O',
'П': 'P', 'П': 'P',
'Р': 'R', 'Р': 'R',
'С': 'S', 'С': 'S',
'Т': 'T', 'Т': 'T',
'У': 'U', 'У': 'U',
'Ф': 'F', 'Ф': 'F',
'Х': 'H', 'Х': 'H',
'Ц': 'C', 'Ц': 'C',
'Ч': 'Ch', 'Ч': 'Ch',
'Ш': 'Sh', 'Ш': 'Sh',
'Щ': 'Sch', 'Щ': 'Sch',
'Ъ': 'J', 'Ъ': 'J',
'Ы': 'I', 'Ы': 'I',
'Ь': 'J', 'Ь': 'J',
'Э': 'E', 'Э': 'E',
'Ю': 'Yu', 'Ю': 'Yu',
'Я': 'Ya' 'Я': 'Ya'
} }

8
anb_python_components/extensions/type_extension.py
View File

@@ -3,21 +3,20 @@
import datetime import datetime
from typing import Any from typing import Any
# Базовая структура для представления расширенного типа # Базовая структура для представления расширенного типа
class TypeExtension: class TypeExtension:
""" """
Класс для расширения типов. Класс для расширения типов.
""" """
def __init__(self): def __init__ (self):
""" """
Инициализирует экземпляр класса. Инициализирует экземпляр класса.
""" """
pass pass
@staticmethod @staticmethod
def to_dict(instance: Any) -> dict[str, Any]: def to_dict (instance: Any) -> dict[str, Any]:
""" """
Преобразует экземпляр объекта в словарь. Преобразует экземпляр объекта в словарь.
@@ -43,7 +42,7 @@ class TypeExtension:
return result return result
@staticmethod @staticmethod
def from_dict(data: dict, cls=None) -> Any: def from_dict (data: dict, cls = None) -> Any:
""" """
Восстанавливает объект из словаря. Восстанавливает объект из словаря.
@@ -58,6 +57,7 @@ class TypeExtension:
raise TypeError('Класс для восстановления не указан.') raise TypeError('Класс для восстановления не указан.')
# Создаём объект класса # Создаём объект класса
# noinspection PyArgumentList
obj = cls.__new__(cls) obj = cls.__new__(cls)
# Перебираем поля словаря # Перебираем поля словаря

1
anb_python_components/types/__init__.py Normal file
View File

@@ -0,0 +1 @@
# anb_python_components/types/__init__.py

34
anb_python_components/classes/guid.py → anb_python_components/types/guid.py
View File

@@ -1,19 +1,31 @@
# anb_python_components/classes/guid.py # anb_python_components/types/guid.py
import re import re
from anb_python_components.exceptions.wrong_type_exception import WrongTypeException from anb_python_components.exceptions.wrong_type_exception import WrongTypeException
# Константа пустого GUID
GUID_EMPTY: str = "00000000-0000-0000-0000-000000000000"
class GUID: class GUID:
"""
Тип GUID.
"""
def __init__(self, guid: str = GUID_EMPTY): # Константа пустого GUID
EMPTY: str = "00000000-0000-0000-0000-000000000000"
def __init__ (self, guid = EMPTY):
""" """
Инициализация расширения. Инициализация расширения.
:param guid: Передаваемый GUID :param guid: str | GUID - Передаваемый GUID
""" """
# Проверка типа аргумента guid
# - если аргумент не является строкой
if not isinstance(guid, str):
# -- если аргумент является экземпляром GUID
if isinstance(guid, GUID):
# - преобразуем его в строку
guid = str(guid)
else:
# -- иначе генерируем исключение
raise WrongTypeException("Неверный тип аргумента!", "GUID", str(type(guid)), "guid")
# Проверка GUID на валидность # Проверка GUID на валидность
if not self.validate_str(guid): if not self.validate_str(guid):
@@ -23,14 +35,14 @@ class GUID:
# Инициализируем приватный атрибут __value (текстовое представление хранящегося GUID) # Инициализируем приватный атрибут __value (текстовое представление хранящегося GUID)
self.__value = guid self.__value = guid
def __str__(self): def __str__ (self):
""" """
Переопределение метода __str__. Переопределение метода __str__.
:return: Текстовое представление GUID. :return: Текстовое представление GUID.
""" """
return self.__value if self.__value else GUID_EMPTY return self.__value if self.__value else self.EMPTY
def __eq__(self, other): def __eq__ (self, other):
""" """
Переопределение метода __eq__. Переопределение метода __eq__.
:param other: Объект для сравнения. :param other: Объект для сравнения.
@@ -49,7 +61,7 @@ class GUID:
return self.__value == other_str return self.__value == other_str
@staticmethod @staticmethod
def validate_str(guid: str | None) -> bool: def validate_str (guid: str | None) -> bool:
""" """
Проверка строки на валидность GUID. Проверка строки на валидность GUID.
:return: True, если GUID валидный, иначе False. :return: True, если GUID валидный, иначе False.