explicit-python-dlq 1.0.0__tar.gz → 2.0.0__tar.gz

{explicit_python_dlq-1.0.0/src/explicit_python_dlq.egg-info → explicit_python_dlq-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: explicit-python-dlq
-Version: 1.0.0
+Version: 2.0.0
 Summary: Набор компонентов реализующих DQL для систем на базе explicit
 Author-email: "АО \"БАРС Груп\"" <education_dev@bars-open.ru>
 Classifier: Intended Audience :: Developers
@@ -8,17 +8,18 @@ Classifier: Environment :: Web Environment
 Classifier: Natural Language :: Russian
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: explicit-python<3,>=2.2.1
+Requires-Dist: explicit-python<4,>=3
 Provides-Extra: dev
 Requires-Dist: freezegun; extra == "dev"
 Provides-Extra: django
-Requires-Dist: explicit-python-django<2.0,>=1.0.2; extra == "django"
+Requires-Dist: explicit-python-django<3,>=2; extra == "django"
 Provides-Extra: rest
 Requires-Dist: djangorestframework>=3.13.0; extra == "rest"
 Requires-Dist: django_filter>=23.3; extra == "rest"
@@ -103,3 +104,40 @@ def bootstrap() -> None:
 В пакете реализованы готовые к использованию компоненты:
 * Реализация абстрактного [хранилища сообщений](./src/explicit/dlq/contrib/django/README.md) на базе Django ORM
 * [REST API](./src/explicit/dlq/contrib/drf/README.md) для работы с хранилищем сообщений. Предназначен для совместной работы с реализацией хранилища сообщений django ORM.
+
+## Запуск тестов
+
+Тесты запускаются через `tox`. В системе должен быть установлен [uv](https://docs.astral.sh/uv/).
+
+Для корректного запуска тестов необходимы следующие значения переменных окружения в системе. Вместо `<login>` и `<password>` необходимо подставить данные от УЗ БАРС:
+
+```bash
+UV_INDEX="internal=http://<login>:<password>@nexus.py.bars.group/repository/pypi-all/simple"
+UV_DEFAULT_INDEX="https://pypi.org/simple"
+UV_INDEX_STRATEGY=unsafe-best-match
+# Для docker 29+
+TOX_DOCKER_GATEWAY=localhost
+```
+
+Чтобы не менять значения системных переменных, можно создать `.env` файл c переменными окружения и запускать команды через [python-dotenv](https://github.com/theskumar/python-dotenv/).
+
+Установка `tox` с необходимыми зависимостями:
+```bash
+uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Или с использованием `python-dotenv`:
+```bash
+dotenv run uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Запуск тестов:
+```bash
+tox
+```
+
+Через `python-dotenv`:
+```bash
+dotenv run tox
+```
+

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/README.md

@@ -78,3 +78,40 @@ def bootstrap() -> None:
 В пакете реализованы готовые к использованию компоненты:
 * Реализация абстрактного [хранилища сообщений](./src/explicit/dlq/contrib/django/README.md) на базе Django ORM
 * [REST API](./src/explicit/dlq/contrib/drf/README.md) для работы с хранилищем сообщений. Предназначен для совместной работы с реализацией хранилища сообщений django ORM.
+
+## Запуск тестов
+
+Тесты запускаются через `tox`. В системе должен быть установлен [uv](https://docs.astral.sh/uv/).
+
+Для корректного запуска тестов необходимы следующие значения переменных окружения в системе. Вместо `<login>` и `<password>` необходимо подставить данные от УЗ БАРС:
+
+```bash
+UV_INDEX="internal=http://<login>:<password>@nexus.py.bars.group/repository/pypi-all/simple"
+UV_DEFAULT_INDEX="https://pypi.org/simple"
+UV_INDEX_STRATEGY=unsafe-best-match
+# Для docker 29+
+TOX_DOCKER_GATEWAY=localhost
+```
+
+Чтобы не менять значения системных переменных, можно создать `.env` файл c переменными окружения и запускать команды через [python-dotenv](https://github.com/theskumar/python-dotenv/).
+
+Установка `tox` с необходимыми зависимостями:
+```bash
+uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Или с использованием `python-dotenv`:
+```bash
+dotenv run uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Запуск тестов:
+```bash
+tox
+```
+
+Через `python-dotenv`:
+```bash
+dotenv run tox
+```
+

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/pyproject.toml

@@ -27,16 +27,17 @@ classifiers=[
     "Natural Language :: Russian",
     "Operating System :: OS Independent",
     "Development Status :: 5 - Production/Stable",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 
 dependencies = [
-  "explicit-python>=2.2.1,<3",
+  "explicit-python>=3,<4",
 ]
 
 [project.optional-dependencies]
@@ -44,7 +45,7 @@ dev = [
     "freezegun"
 ]
 django = [
-    "explicit-python-django>=1.0.2,<2.0"
+    "explicit-python-django>=2,<3"
 ]
 rest = [
     "djangorestframework>=3.13.0",
@@ -62,19 +63,21 @@ include_trailing_comma = true
 line_length = 120
 combine_as_imports = true
 lines_after_imports = 2
-extra_standard_library = ["dataclasses"]
 known_project = ["explicit", "testapp"]
 sections = ["FUTURE","STDLIB","THIRDPARTY","FIRSTPARTY","PROJECT","LOCALFOLDER"]
 
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py310"
 line-length = 120
 indent-width = 4
+exclude = [
+    "**/migrations/*.py",
+]
 
 
 [tool.ruff.lint]
-select = ["F", "E", "D", "W", "S", "N",]
+select = ["F", "E", "D", "W", "S", "N", "UP007", "UP045"]
 ignore = [
     # Missing docstring in public module
     "D100",
@@ -85,36 +88,9 @@ ignore = [
     # use of assert detected (useless with pytest)
     "S101",
 ]
-exclude = [
-    ".bzr",
-    ".direnv",
-    ".eggs",
-    ".git",
-    ".git-rewrite",
-    ".hg",
-    ".idea",
-    ".ipynb_checkpoints",
-    ".mypy_cache",
-    ".nox",
-    ".pants.d",
-    ".pyenv",
-    ".pytest_cache",
-    ".pytype",
-    ".ruff_cache",
-    ".svn",
-    ".tox",
-    ".venv",
-    ".vscode",
-    "__pypackages__",
-    "_build",
-    "buck-out",
-    "build",
-    "dist",
-    "node_modules",
-    "site-packages",
-    "venv",
-    "py-libs/**",
-]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
 
 [tool.ruff.format]
 quote-style = "single"
@@ -122,8 +98,8 @@ indent-style = "space"
 docstring-code-format = true
 
 [tool.ruff.lint.per-file-ignores]
-"*/tests/*" = ["D"]
-"*/migrations/*" = ["D"]
+"**/testapp/**" = ["D"]
+"**/testapp/settings.py" = ["S105"]
 
 [tool.mypy]
 plugins = ["pydantic.mypy"]

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/config.py

@@ -7,10 +7,6 @@ from typing import (
     TYPE_CHECKING,
 )
 
-from pydantic import (
-    ConfigDict,
-)
-
 from explicit.dlq.domain import (
     commands,
 )
@@ -35,8 +31,6 @@ if TYPE_CHECKING:
 class DLQConfig:
     """Конфигурация DLQ."""
 
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
     bus: 'MessageBus'
     repository: 'AbstractDLQRepository'
     message_dispatcher: 'DLQMessageDispatcher'

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/contrib/django/README.md

@@ -7,13 +7,12 @@ testapp/settings.py:
 INSTALLED_APPS = [
     # другие приложения
     'explicit.dlq.contrib.django',  # подключение приложения с моделью DeadLetter
-    'testapp.core',                 # настройка компонентов из explicit.dlq
+    'testapp.core',  # настройка компонентов из explicit.dlq
 ]
 ```
 
 testapp/dlq/apps.py:
 ```python
-
 from datetime import timedelta
 
 from django.apps import AppConfig as AppConfigBase
@@ -27,9 +26,10 @@ class AppConfig(AppConfigBase):
 
     def _configure_dlq(self):
         from explicit.dlq.config import DLQConfig, configure_dlq
-        
-        # реализация репозитория на базе Django ORM 
+
+        # реализация репозитория на базе Django ORM
         from explicit.dlq.contrib.django.adapters.db import Repository
+
         config = DLQConfig(
             # ...
             repository=Repository(),

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/contrib/django/adapters/db.py

@@ -1,9 +1,10 @@
 """Адаптеры для работы с Dead Letter Queue (DLQ) в базе данных."""
 
+from collections.abc import (
+    Iterator,
+)
 from typing import (
     TYPE_CHECKING,
-    Iterator,
-    Union,
 )
 
 from django.core.exceptions import (
@@ -95,7 +96,7 @@ class Repository(AbstractDLQRepository):
         for db_instance in self._base_qs.iterator():
             yield self._to_domain(db_instance)
 
-    def get_object_by_id(self, identifier: 'Union[UUID, str]') -> DeadLetter:
+    def get_object_by_id(self, identifier: 'UUID | str') -> DeadLetter:
         """Получить сообщение по идентификатору."""
         try:
             db_instance = self._base_qs.get(pk=identifier)

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/contrib/django/models.py

@@ -12,8 +12,12 @@ from django.db import (
 )
 
 from explicit.dlq.domain.model import (
+    TOPIC_MAX_LENGTH,
     DeadLetter as DomainDeadLetter,
 )
+from explicit.domain import (
+    get_field_title,
+)
 
 
 if DJANGO_VERSION >= (4, 0):
@@ -27,12 +31,18 @@ else:
 class DeadLetter(models.Model):
     """Недоставленное/необработанное сообщение."""
 
-    id = models.UUIDField(primary_key=True, default=uuid4, editable=False, verbose_name=DomainDeadLetter.id.title)
-    raw_message_value = models.BinaryField(verbose_name=DomainDeadLetter.raw_message_value.title)
-    raw_message_key = models.BinaryField(verbose_name=DomainDeadLetter.raw_message_key.title, null=True, blank=True)
-    topic = models.CharField(verbose_name=DomainDeadLetter.topic.title, max_length=DomainDeadLetter.topic.max_length)
-    attempts = JSONField(verbose_name=DomainDeadLetter.attempts.title)
-    processed_at = models.DateTimeField(verbose_name=DomainDeadLetter.processed_at.title, null=True, blank=True)
+    id = models.UUIDField(
+        primary_key=True, default=uuid4, editable=False, verbose_name=get_field_title(DomainDeadLetter, 'id')
+    )
+    raw_message_value = models.BinaryField(verbose_name=get_field_title(DomainDeadLetter, 'raw_message_value'))
+    raw_message_key = models.BinaryField(
+        verbose_name=get_field_title(DomainDeadLetter, 'raw_message_key'), null=True, blank=True
+    )
+    topic = models.CharField(verbose_name=get_field_title(DomainDeadLetter, 'topic'), max_length=TOPIC_MAX_LENGTH)
+    attempts = JSONField(verbose_name=get_field_title(DomainDeadLetter, 'attempts'))
+    processed_at = models.DateTimeField(
+        verbose_name=get_field_title(DomainDeadLetter, 'processed_at'), null=True, blank=True
+    )
 
     # служебные поля используемые для фильтрации и сортировки, чтобы не лезть в json
     _first_attempted_at = models.DateTimeField(db_index=True)

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/contrib/drf/README.md

@@ -14,7 +14,6 @@ class DeadLetterQueueViewSet(BaseDeadLetterQueueViewSet):
         from testapp import core
 
         return core.bus.handle(command)
-
 ```
 
 testapp/rest/urls.py:

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/domain/commands.py

@@ -1,12 +1,13 @@
 """Команды DLQ."""
 
-from typing import (
-    Optional,
-)
 from uuid import (
     UUID,
 )
 
+from pydantic import (
+    ConfigDict,
+)
+
 from explicit.messagebus.commands import (
     Command,
 )
@@ -15,14 +16,13 @@ from explicit.messagebus.commands import (
 class RegisterDeadLetter(Command):
     """Зарегистрировать сообщение, которое не удалось обработать."""
 
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
     topic: str
     raw_message_value: bytes
-    raw_message_key: Optional[bytes] = None
+    raw_message_key: bytes | None = None
     exception: Exception
 
-    class Config:  # noqa: D106
-        arbitrary_types_allowed = True
-
 
 class ProcessDeadLetter(Command):
     """Выполнить попытку обработки сообщения."""

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/domain/factories.py

@@ -5,9 +5,6 @@ from datetime import (
     datetime,
     timezone,
 )
-from typing import (
-    Union,
-)
 
 from explicit.domain import (
     Str,
@@ -21,9 +18,6 @@ from explicit.domain.model import (
     Unset,
     unset,
 )
-from explicit.domain.types import (
-    NoneStr,
-)
 
 from .model import (
     Attempt,
@@ -34,7 +28,7 @@ from .model import (
 class AttemptDTO(DTOBase):
     """Объект передачи данных о попытке обработки сообщения."""
 
-    failed_at: Union[datetime, Unset] = unset
+    failed_at: datetime | Unset = unset
     error_message: Str = unset
     traceback: Str = unset
 
@@ -43,11 +37,11 @@ class DeadLetterDTO(DTOBase):
     """Объект передачи данных о необработанном сообщении."""
 
     id: UnsetUUID = unset
-    raw_message_value: Union[bytes, Unset] = unset
-    raw_message_key: NoneStr = unset
+    raw_message_value: bytes | Unset = unset
+    raw_message_key: bytes | None | Unset = unset
     topic: Str = unset
-    attempts: Union[list[AttemptDTO], Unset] = unset
-    processed_at: Union[datetime, None, Unset] = unset
+    attempts: list[AttemptDTO] | Unset = unset
+    processed_at: datetime | None | Unset = unset
 
 
 class Factory(AbstractDomainFactory):
@@ -55,7 +49,7 @@ class Factory(AbstractDomainFactory):
 
     def create(self, data: DeadLetterDTO) -> DeadLetter:
         """Создать DLQ из DTO."""
-        params = data.dict()
+        params = data.model_dump()
 
         return DeadLetter(**params)
 
@@ -68,7 +62,7 @@ class Factory(AbstractDomainFactory):
         )
 
     def create_from_exception(
-        self, raw_message_value: bytes, raw_message_key: Union[bytes, None], topic: str, exception: Exception
+        self, raw_message_value: bytes, raw_message_key: bytes | None, topic: str, exception: Exception
     ) -> DeadLetter:
         """Создать DLQ из исключения."""
         attempt = self.create_attempt_from_exception(exception)

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/domain/model.py

@@ -7,13 +7,11 @@ from datetime import (
 )
 from typing import (
     TYPE_CHECKING,
-    Optional,
-    Union,
 )
 
 from pydantic import (
     Field,
-    validator,
+    field_validator,
 )
 
 from explicit.contrib.domain.model import (
@@ -22,9 +20,16 @@ from explicit.contrib.domain.model import (
 
 
 if TYPE_CHECKING:
-    from dataclasses import dataclass  # noqa
+    from dataclasses import (
+        dataclass,
+    )
 else:
-    from pydantic.dataclasses import dataclass  # noqa
+    from pydantic.dataclasses import (
+        dataclass,
+    )
+
+
+TOPIC_MAX_LENGTH = 256
 
 
 class DeadLetterNotFound(Exception):  # noqa: N818
@@ -49,12 +54,14 @@ class DeadLetter:
 
     id: uuid.UUID = uuid_identifier()
     raw_message_value: bytes = Field(title='Содержимое сообщения')
-    raw_message_key: Union[bytes, None] = Field(title='Ключ сообщения', default=None)
-    topic: str = Field(title='Топик сообщения', max_length=256)
-    attempts: tuple[Attempt, ...] = Field(default_factory=tuple, title='Попытки обработки сообщения')
-    processed_at: Optional[datetime] = Field(default=None, title='Время успешной обработки сообщения')
-
-    @validator('attempts', always=True)
+    raw_message_key: bytes | None = Field(title='Ключ сообщения', default=None)
+    topic: str = Field(title='Топик сообщения', max_length=TOPIC_MAX_LENGTH)
+    attempts: tuple[Attempt, ...] = Field(
+        default_factory=tuple, validate_default=True, title='Попытки обработки сообщения'
+    )
+    processed_at: datetime | None = Field(default=None, title='Время успешной обработки сообщения')
+
+    @field_validator('attempts')
     @classmethod
     def _validate_attempts(cls, value):
         if not value:

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/domain/services.py

@@ -1,9 +1,5 @@
 """Сервисы предметной области для работы с DLQ."""
 
-from typing import (
-    Optional,
-)
-
 from explicit.unit_of_work import (
     AbstractUnitOfWork,
 )
@@ -19,7 +15,7 @@ from .model import (
 
 def register_dead_letter(
     raw_message_value: bytes,
-    raw_message_key: Optional[bytes],
+    raw_message_key: bytes | None,
     topic: str,
     exception: Exception,
     uow: 'AbstractUnitOfWork',

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit/dlq/infrastructure/handlers.py

@@ -3,9 +3,6 @@
 from contextlib import (
     AbstractContextManager,
 )
-from typing import (
-    Optional,
-)
 
 from explicit.dlq.domain.commands import (
     RegisterDeadLetter,
@@ -40,7 +37,7 @@ class RegisterInDLQOnFailure(AbstractContextManager):
         bus: 'MessageBus',
         topic: str,
         raw_message_value: bytes,
-        raw_message_key: Optional[bytes] = None,
+        raw_message_key: bytes | None = None,
     ):
         self._bus = bus
         self._topic = topic

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0/src/explicit_python_dlq.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: explicit-python-dlq
-Version: 1.0.0
+Version: 2.0.0
 Summary: Набор компонентов реализующих DQL для систем на базе explicit
 Author-email: "АО \"БАРС Груп\"" <education_dev@bars-open.ru>
 Classifier: Intended Audience :: Developers
@@ -8,17 +8,18 @@ Classifier: Environment :: Web Environment
 Classifier: Natural Language :: Russian
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: explicit-python<3,>=2.2.1
+Requires-Dist: explicit-python<4,>=3
 Provides-Extra: dev
 Requires-Dist: freezegun; extra == "dev"
 Provides-Extra: django
-Requires-Dist: explicit-python-django<2.0,>=1.0.2; extra == "django"
+Requires-Dist: explicit-python-django<3,>=2; extra == "django"
 Provides-Extra: rest
 Requires-Dist: djangorestframework>=3.13.0; extra == "rest"
 Requires-Dist: django_filter>=23.3; extra == "rest"
@@ -103,3 +104,40 @@ def bootstrap() -> None:
 В пакете реализованы готовые к использованию компоненты:
 * Реализация абстрактного [хранилища сообщений](./src/explicit/dlq/contrib/django/README.md) на базе Django ORM
 * [REST API](./src/explicit/dlq/contrib/drf/README.md) для работы с хранилищем сообщений. Предназначен для совместной работы с реализацией хранилища сообщений django ORM.
+
+## Запуск тестов
+
+Тесты запускаются через `tox`. В системе должен быть установлен [uv](https://docs.astral.sh/uv/).
+
+Для корректного запуска тестов необходимы следующие значения переменных окружения в системе. Вместо `<login>` и `<password>` необходимо подставить данные от УЗ БАРС:
+
+```bash
+UV_INDEX="internal=http://<login>:<password>@nexus.py.bars.group/repository/pypi-all/simple"
+UV_DEFAULT_INDEX="https://pypi.org/simple"
+UV_INDEX_STRATEGY=unsafe-best-match
+# Для docker 29+
+TOX_DOCKER_GATEWAY=localhost
+```
+
+Чтобы не менять значения системных переменных, можно создать `.env` файл c переменными окружения и запускать команды через [python-dotenv](https://github.com/theskumar/python-dotenv/).
+
+Установка `tox` с необходимыми зависимостями:
+```bash
+uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Или с использованием `python-dotenv`:
+```bash
+dotenv run uv tool install tox --with tox-uv --with m3-tox-docker
+```
+
+Запуск тестов:
+```bash
+tox
+```
+
+Через `python-dotenv`:
+```bash
+dotenv run tox
+```
+

{explicit_python_dlq-1.0.0 → explicit_python_dlq-2.0.0}/src/explicit_python_dlq.egg-info/requires.txt

@@ -1,10 +1,10 @@
-explicit-python<3,>=2.2.1
+explicit-python<4,>=3
 
 [dev]
 freezegun
 
 [django]
-explicit-python-django<2.0,>=1.0.2
+explicit-python-django<3,>=2
 
 [rest]
 djangorestframework>=3.13.0