anb-python-components 1.4.2__tar.gz → 1.5.0__tar.gz

{anb_python_components-1.4.2 → anb_python_components-1.5.0}/PKG-INFO

@@ -1,149 +1,148 @@
-Metadata-Version: 2.4
-Name: anb_python_components
-Version: 1.4.2
-Summary: Набор компонентов Python, которые упрощают разработку / A set of Python components that simplify development
-Home-page: https://gitflic.ru/project/babaev-an/anb-python-components
-Author: Александр Бабаев
-Author-email: contact_with_us@babaev-an.ru
-Project-URL: Documentation, https://gitflic.ru/project/babaev-an/anb-python-components/wiki
-Project-URL: Source, https://gitflic.ru/project/babaev-an/anb-python-components
-Project-URL: Tracker, https://gitflic.ru/project/babaev-an/anb-python-components/issue?page=0
-Keywords: python components development utils
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.14.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: setuptools>=80.9.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# 📌🇷🇺 Русская версия
-
----
-
-## Набор компонентов Python для упрощения разработки приложений
-
-**ANB Python Components** — это библиотека полезных классов и модулей, предназначенная для ускорения процесса разработки
-программного обеспечения на языке программирования Python. Библиотека включает широкий спектр инструментов, облегчающих
-выполнение повседневных задач разработчика, от обработки файлов и сетевых запросов до автоматизации тестирования и
-интеграции с популярными фреймворками.
-
-### ✅ Основные возможности:
-
-- Удобные инструменты для работы с файлами и каталогами.
-- Классы для работы с файлами и директориями.
-- Классы для удобной передачи состояния.
-- Новые
-  типы [GUID](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fguid.md),
-  [TwoDimSize](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Ftwo_dim_size.md), [VersionInfo](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fversion_info.md), [ShortCodeAttributes](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fshortcode_attributes.md)
-  и [ObjectArray](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fobject_array.md).
-- Расширение массивов, типа `bool`, типа `GUID`, типа `str`.
-- Класс для перевода любого типа в строку и наоборот.
-
-### ⚙️ Установка и использование:
-
-Установить пакет можно через pip:
-
-```bash
-pip install anb-python-components
-```
-
-Подключайте необходимые модули и начните пользоваться ими прямо сейчас:
-
-```python
-from anb_python_components import TwoDimSize
-
-# Пример использования
-two_dim = TwoDimSize.parse('100x150', 'x')
-
-# Теперь присваиваем какому-либо объекту
-some_object_width = two_dim.width
-some_object_height = two_dim.height
-```
-
-### 🛠️ Поддерживаемые технологии:
-
-- `Python` версии 3.14.0 и выше
-- Совместима с большинством популярных веб-фреймворков и библиотек Python
-- Оптимизирован для работы с большими объемами данных и высоконагруженными приложениями
-
-### 💬 Вопросы и поддержка:
-
-Для подробной справки обратитесь к руководству по библиотеке в разделе документации:
-
-🔗 Справочное руководство → [Документация библиотеки](https://gitflic.ru/project/babaev-an/anb-python-components/wiki)
-
----
-
-# 📌🇬🇧 English Version
-
----
-
-## Python Component Collection for Streamlining Application Development
-
-**ANB Python Components** is a collection of useful classes and modules specifically tailored to accelerate the process
-of developing software using the Python programming language. It offers a broad spectrum of tools that simplify everyday
-developer tasks, from file manipulation and network requests to test automation and seamless integration with widely
-used frameworks.
-
-### ✅ Main Features:
-
-- Handy tools for working with files and directories.
-- Classes for handling files and folders.
-- Classes for convenient state transfer.
-- New custom_types such
-  as [GUID](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fguid.md),
-  [TwoDimSize](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Ftwo_dim_size.md), [VersionInfo](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fversion_info.md), [ShortCodeAttributes](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fshortcode_attributes.md)
-  and [ObjectArray](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fobject_array.md).
-- Extensions for arrays, `bool`, `GUID`, and `str` custom_types.
-- Class for converting any type into string representation and vice versa.
-
-### ⚙️ Installation and Usage:
-
-You can install this package via pip:
-
-```bash
-pip install anb-python-components
-```
-
-Import required modules and start using them immediately:
-
-```python
-from anb_python_components import TwoDimSize
-
-# Example usage
-two_dim = TwoDimSize.parse('100x150', 'x')
-
-# Now assign it to some object
-some_object_width = two_dim.width
-some_object_height = two_dim.height
-```
-
-### 🛠️ Supported Technologies:
-
-- **Python**: version 3.14.0 or higher
-- Compatibility with most popular Python web frameworks and libraries
-- Optimized for performance with large-scale datasets and highly loaded applications
-
-### 💬 Questions and Support:
-
-For comprehensive guidance and support, consult the library's documentation section:
-
-🔗 Reference Guide → [Library Documentation](https://gitflic.ru/project/babaev-an/anb-python-components/wiki) (in Russian
-Only)
+Metadata-Version: 2.4
+Name: anb_python_components
+Version: 1.5.0
+Summary: Набор компонентов Python, которые упрощают разработку / A set of Python components that simplify development
+Home-page: https://gitflic.ru/project/babaev-an/anb-python-components
+Author: Александр Бабаев
+Author-email: contact_with_us@babaev-an.ru
+Project-URL: Documentation, https://gitflic.ru/project/babaev-an/anb-python-components/wiki
+Project-URL: Source, https://gitflic.ru/project/babaev-an/anb-python-components
+Project-URL: Tracker, https://gitflic.ru/project/babaev-an/anb-python-components/issue?page=0
+Keywords: python components development utils
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools>=80.9.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 📌🇷🇺 Русская версия
+
+---
+
+## Набор компонентов Python для упрощения разработки приложений
+
+**ANB Python Components** — это библиотека полезных классов и модулей, предназначенная для ускорения процесса разработки
+программного обеспечения на языке программирования Python. Библиотека включает широкий спектр инструментов, облегчающих
+выполнение повседневных задач разработчика, от обработки файлов и сетевых запросов до автоматизации тестирования и
+интеграции с популярными фреймворками.
+
+### ✅ Основные возможности:
+
+- Удобные инструменты для работы с файлами и каталогами.
+- Классы для работы с файлами и директориями.
+- Классы для удобной передачи состояния.
+- Новые
+  типы [GUID](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fguid.md),
+  [TwoDimSize](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Ftwo_dim_size.md), [VersionInfo](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fversion_info.md), [ShortCodeAttributes](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fshortcode_attributes.md)
+  и [ObjectArray](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fobject_array.md).
+- Расширение массивов, типа `bool`, типа `GUID`, типа `str`.
+- Класс для перевода любого типа в строку и наоборот.
+
+### ⚙️ Установка и использование:
+
+Установить пакет можно через pip:
+
+```bash
+pip install anb-python-components
+```
+
+Подключайте необходимые модули и начните пользоваться ими прямо сейчас:
+
+```python
+from anb_python_components import TwoDimSize
+
+# Пример использования
+two_dim = TwoDimSize.parse('100x150', 'x')
+
+# Теперь присваиваем какому-либо объекту
+some_object_width = two_dim.width
+some_object_height = two_dim.height
+```
+
+### 🛠️ Поддерживаемые технологии:
+
+- `Python` версии 3.10.6 и выше
+- Совместима с большинством популярных веб-фреймворков и библиотек Python
+- Оптимизирован для работы с большими объемами данных и высоконагруженными приложениями
+
+### 💬 Вопросы и поддержка:
+
+Для подробной справки обратитесь к руководству по библиотеке в разделе документации:
+
+🔗 Справочное руководство → [Документация библиотеки](https://gitflic.ru/project/babaev-an/anb-python-components/wiki)
+
+---
+
+# 📌🇬🇧 English Version
+
+---
+
+## Python Component Collection for Streamlining Application Development
+
+**ANB Python Components** is a collection of useful classes and modules specifically tailored to accelerate the process
+of developing software using the Python programming language. It offers a broad spectrum of tools that simplify everyday
+developer tasks, from file manipulation and network requests to test automation and seamless integration with widely
+used frameworks.
+
+### ✅ Main Features:
+
+- Handy tools for working with files and directories.
+- Classes for handling files and folders.
+- Classes for convenient state transfer.
+- New custom_types such
+  as [GUID](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fguid.md),
+  [TwoDimSize](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Ftwo_dim_size.md), [VersionInfo](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fversion_info.md), [ShortCodeAttributes](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fshortcode_attributes.md)
+  and [ObjectArray](https://gitflic.ru/project/babaev-an/anb-python-components/wiki/page?file=class_desc%2Fcustom_types%2Fobject_array.md).
+- Extensions for arrays, `bool`, `GUID`, and `str` custom_types.
+- Class for converting any type into string representation and vice versa.
+
+### ⚙️ Installation and Usage:
+
+You can install this package via pip:
+
+```bash
+pip install anb-python-components
+```
+
+Import required modules and start using them immediately:
+
+```python
+from anb_python_components import TwoDimSize
+
+# Example usage
+two_dim = TwoDimSize.parse('100x150', 'x')
+
+# Now assign it to some object
+some_object_width = two_dim.width
+some_object_height = two_dim.height
+```
+
+### 🛠️ Supported Technologies:
+
+- **Python**: version 3.10.6 or higher
+- Compatibility with most popular Python web frameworks and libraries
+- Optimized for performance with large-scale datasets and highly loaded applications
+
+### 💬 Questions and Support:
+
+For comprehensive guidance and support, consult the library's documentation section:
+
+🔗 Reference Guide → [Library Documentation](https://gitflic.ru/project/babaev-an/anb-python-components/wiki) (in Russian
+Only)

{anb_python_components-1.4.2 → anb_python_components-1.5.0}/README.md

@@ -44,7 +44,7 @@ some_object_height = two_dim.height
 
 ### 🛠️ Поддерживаемые технологии:
 
-- `Python` версии 3.14.0 и выше
+- `Python` версии 3.10.6 и выше
 - Совместима с большинством популярных веб-фреймворков и библиотек Python
 - Оптимизирован для работы с большими объемами данных и высоконагруженными приложениями
 
@@ -102,7 +102,7 @@ some_object_height = two_dim.height
 
 ### 🛠️ Supported Technologies:
 
-- **Python**: version 3.14.0 or higher
+- **Python**: version 3.10.6 or higher
 - Compatibility with most popular Python web frameworks and libraries
 - Optimized for performance with large-scale datasets and highly loaded applications
 

anb_python_components-1.5.0/anb_python_components/__init__.py

@@ -0,0 +1,65 @@
+# anb_python_components/__init__.py
+
+# classes
+from anb_python_components.classes import (
+    ActionState, DataclassAnalyzer, Directory, File, Interface, ShortCodeParser, Logger
+)
+# custom_types
+from anb_python_components.custom_types import GUID, ObjectArray, ShortCodeAttributes, TwoDimSize, VersionInfo
+# decorators
+from anb_python_components.decorators import implement, interface_required
+# enums
+from anb_python_components.enums import MessageType, NotBoolAction, TypeCopyStrategy
+# exceptions
+from anb_python_components.exceptions import WrongTypeException
+# extensions
+from anb_python_components.extensions import (
+    ArrayExtension, BoolExtension, DataClassExtension, StringExtension, TypeExtension
+)
+# log_formatters
+from anb_python_components.log_formatters import DefaultLogFormatter, RussianLogFormatter
+# log_handlers
+from anb_python_components.log_handlers import (
+    ConsoleHandler, FileHandler, RotatingFileHandler, BufferedFileHandler, BufferedRotatingFileHandler
+)
+# models
+from anb_python_components.models import ActionStateMessage, ShortCodeModel
+# protocols
+from anb_python_components.protocols import ILogFormatter, ILogHandler
+
+__all__ = [
+    'ActionState',
+    'Directory',
+    'File',
+    'DataclassAnalyzer',
+    'Interface',
+    'ShortCodeParser',
+    'Logger',
+    'GUID',
+    'ObjectArray',
+    'ShortCodeAttributes',
+    'TwoDimSize',
+    'VersionInfo',
+    'interface_required',
+    'implement',
+    'MessageType',
+    'NotBoolAction',
+    'TypeCopyStrategy',
+    'WrongTypeException',
+    'ArrayExtension',
+    'BoolExtension',
+    'StringExtension',
+    'TypeExtension',
+    'DataClassExtension',
+    'DefaultLogFormatter',
+    'RussianLogFormatter',
+    'ConsoleHandler',
+    'FileHandler',
+    'RotatingFileHandler',
+    'BufferedFileHandler',
+    'BufferedRotatingFileHandler',
+    'ActionStateMessage',
+    'ShortCodeModel',
+    'ILogFormatter',
+    'ILogHandler'
+]

{anb_python_components-1.4.2 → anb_python_components-1.5.0}/anb_python_components/classes/__init__.py

@@ -1,8 +1,9 @@
-# anb_python_components/classes/__init__.py
-
-from anb_python_components.classes.action_state import ActionState
-from anb_python_components.classes.dataclass_analyzer import DataclassAnalyzer
-from anb_python_components.classes.directory import Directory
-from anb_python_components.classes.file import File
-from anb_python_components.classes.interface import Interface
+# anb_python_components/classes/__init__.py
+
+from anb_python_components.classes.action_state import ActionState
+from anb_python_components.classes.dataclass_analyzer import DataclassAnalyzer
+from anb_python_components.classes.directory import Directory
+from anb_python_components.classes.file import File
+from anb_python_components.classes.interface import Interface
+from anb_python_components.classes.logger import Logger
 from anb_python_components.classes.shortcode_parser import ShortCodeParser

{anb_python_components-1.4.2 → anb_python_components-1.5.0}/anb_python_components/classes/action_state.py

@@ -1,19 +1,24 @@
 # anb_python_components/classes/action_state.py
 import copy
-from typing import Callable
+from typing import Any, Callable
 
 from anb_python_components.enums.message_type import MessageType
 from anb_python_components.exceptions.wrong_type_exception import WrongTypeException
 from anb_python_components.models.action_state_message import ActionStateMessage
 
-class ActionState[T]:
+# noinspection Annotator
+class ActionState:
     """
     Класс для хранения состояния действия.
     """
     
-    def __init__ (self, default: T | None = None):
+    def __init__ (self, default: Any = None):
+        """
+        Инициализация.
+        :param default: Значение по-умолчанию.
+        """
         self.__messages: list[ActionStateMessage] = []
-        self.value: T | None = copy.deepcopy(default) if default is not None else None
+        self.value: Any = copy.deepcopy(default) if default is not None else None
     
     @staticmethod
     def get_string_error_only () -> Callable[[ActionStateMessage], bool]:

{anb_python_components-1.4.2 → anb_python_components-1.5.0}/anb_python_components/classes/directory.py

@@ -18,7 +18,7 @@ class Directory:
             }
     
     @staticmethod
-    def remove (directory: str, error_messages: dict[str, str] | None = None) -> ActionState[bool]:
+    def remove (directory: str, error_messages: dict[str, str] | None = None) -> ActionState:
         """
         Рекурсивно удаляет директорию с соответствующим результатом.
 
@@ -27,7 +27,7 @@ class Directory:
         :return: Объект ActionState с информацией о результате.
         """
         # Создаем объект ActionState для хранения результата
-        result = ActionState[bool](False)
+        result = ActionState(False)
         
         # Если не заданы сообщения об ошибках
         if error_messages is None: