various-api-tools 1.0.0__tar.gz → 2.0.0__tar.gz

{various_api_tools-1.0.0 → various_api_tools-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: various-api-tools
-Version: 1.0.0
+Version: 2.0.0
 Summary: A lightweight utility package for common API-related tasks in Python, including JSON and Pydantic error translators that provide user-friendly Russian messages.
 Author-Email: dkurchigin <kurchigin.dmitry@yandex.ru>
 License: MIT

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

@@ -1,6 +1,6 @@
 [project]
 name = "various-api-tools"
-version = "1.0.0"
+version = "2.0.0"
 description = "A lightweight utility package for common API-related tasks in Python, including JSON and Pydantic error translators that provide user-friendly Russian messages."
 authors = [
     { name = "dkurchigin", email = "kurchigin.dmitry@yandex.ru" },
@@ -160,6 +160,7 @@ dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
 ]
 "src/various_api_tools/translators/psycopg/base.py" = [
     "ANN401",
+    "RUF012",
 ]
 "src/various_api_tools/translators/psycopg/psycopg.py" = [
     "ANN401",

various_api_tools-2.0.0/src/various_api_tools/translators/psycopg/base.py

@@ -0,0 +1,256 @@
+"""Abstract base class for translating psycopg/psycopg2 database errors.
+
+This module provides a foundation for parsing PostgreSQL error
+details (such as `pgcode` and `pgerror`) from psycopg exceptions and converting
+them into structured, human-readable error descriptions.
+It supports both `psycopg2` and `psycopg3` by abstracting access to error attributes,
+allowing concrete implementations to handle version-specific details.
+"""
+
+import re
+from typing import Any
+
+from .constants import (
+    CHECK_VIOLATION_PATTERN,
+    DEFAULT_CODE_MAP,
+    UNIQUE_VIOLATION_PATTERN,
+    UNKNOWN_CHECK_DESCRIPTION,
+    UNKNOWN_CODE,
+    UNKNOWN_USER_RAISE_DESCRIPTION,
+)
+
+
+class BasePsycopgTranslator:
+    """Base translator for turning psycopg errors into user-friendly messages.
+
+    Supports customization via:
+    - `code_map`: maps SQLSTATE codes to human-readable messages
+    - `check_map`: maps check constraint names to meaningful descriptions
+    - `user_map`: maps database column names to user-friendly field names
+
+    Subclasses must implement `_get_pgcode()` and `_get_pgerror()` to support specific
+    psycopg versions (e.g., psycopg2 vs. psycopg3).
+
+    Attributes:
+        code_map (dict): Mapping from SQLSTATE codes (str) to error messages (str).
+        check_map (dict): Mapping from check constraint names (str)
+            to descriptions (str).
+        user_map (dict): Mapping from DB column/field names (str)
+            to user-friendly names (str).
+
+    """
+
+    code_map: dict
+    check_map: dict
+    user_map: dict
+
+    check_codes: list[str] = ["23514"]
+    unique_codes: list[str] = ["23505", "23503"]
+    user_codes: list[str] = ["P0001"]
+
+    def __init__(
+        self,
+        *,
+        code_map: dict | None = None,
+        check_map: dict | None = None,
+        user_map: dict | None = None,
+    ) -> None:
+        """Initialize the translator with optional custom message mappings.
+
+        Args:
+            code_map: Optional mapping from SQLSTATE codes (e.g. '23505') to
+                error messages. If None, defaults to `DEFAULT_CODE_MAP`.
+            check_map: Optional mapping from check constraint names to
+                descriptive messages. If None, defaults to an empty dict.
+            user_map: Optional mapping from database column names to
+                user-friendly field names.
+                    Used to improve readability in error messages.
+                    Example: {"email": "Email пользователя", "phone": "Номер телефона"}
+                    If None, defaults to an empty dict.
+
+        Example:
+        ```python
+            custom_codes = {"23505": "Значение уже существует"}
+            custom_checks = {"age_check": "Возраст должен быть от 18 до 120"}
+            t = BasePsycopgTranslator(code_map=custom_codes, check_map=custom_checks)
+        ```
+
+        """
+        self.code_map = code_map if code_map is not None else DEFAULT_CODE_MAP
+        self.check_map = check_map if check_map is not None else {}
+        self.user_map = user_map if user_map is not None else {}
+
+    def translate(
+        self,
+        error: Any,
+    ) -> str:
+        """Translate a psycopg database error into a user-friendly message.
+
+        Extracts `pgcode` and `pgerror` from the error and formats a meaningful response
+        based on the type of constraint violation (unique, check, foreign key).
+
+        Args:
+            error: A psycopg exception (e.g. IntegrityError, DatabaseError).
+
+        Returns:
+            A formatted error message, or a fallback if no match is found.
+
+        Example:
+        ```python
+            # Given error: unique_violation on email = 'test@example.com'
+            print(translator.translate(error))
+            #> "БД уже содержит значение: ключ email, значение test@example.com"
+        ```
+
+        """
+        msg: str = UNKNOWN_CODE
+
+        pgcode = self._get_pgcode(error)
+        pgerror = self._get_pgerror(error)
+
+        if pgcode is not None:
+            code_msg: str | None = self.code_map.get(pgcode, UNKNOWN_CODE)
+
+            if pgcode in self.check_codes:
+                msg = self._translate_check_violation(
+                    code_msg=code_msg,
+                    error_msg=pgerror,
+                )
+            elif pgcode in self.unique_codes:
+                msg = self._translate_unique_violation(
+                    code_msg=code_msg,
+                    error_msg=pgerror,
+                )
+            elif pgcode in self.user_codes:
+                msg = self._translate_user_raise(code_msg=code_msg, error_msg=pgerror)
+
+        return msg
+
+    def _get_pgcode(self, error: Any) -> str | None:
+        """Extract pgcode code from the error.
+
+        Must be implemented by subclasses to support specific psycopg versions.
+
+        Args:
+            error: The raw database exception.
+
+        Returns:
+            The SQLSTATE code as a string (e.g. '23505'), or None if not available.
+
+        """
+        raise NotImplementedError
+
+    def _get_pgerror(self, error: Any) -> str | None:
+        """Extract the full error message from the exception.
+
+        Must be implemented by subclasses to support specific psycopg versions.
+
+        Args:
+            error: The raw database exception.
+
+        Returns:
+            Full error message string, or None if not available.
+
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def _translate_unique_violation(cls, code_msg: str, error_msg: str) -> str:
+        """Extract details from a unique constraint violation and format a message.
+
+        Parses the PostgreSQL error message to extract the violated field and
+        its conflicting value using a predefined regex pattern.
+
+        Args:
+            code_msg: Base message from code_map for this error type.
+            error_msg: Full PostgreSQL error text.
+
+        Returns:
+            Formatted message with field name and value if found;
+            otherwise returns the base code_msg.
+
+        Example:
+            For error_msg = "DETAIL: Key (email)=(user@example.com) already exists",
+            returns: "БД уже содержит значение: ключ email, значение user@example.com"
+
+        """
+        msg = code_msg
+
+        pattern = re.compile(UNIQUE_VIOLATION_PATTERN)
+        matched = pattern.search(error_msg)
+
+        if matched is not None:
+            constraint = matched.group(2)
+            description = matched.group(3)
+            if constraint and description:
+                msg = f"{code_msg}: ключ {constraint}, значение {description}"
+
+        return msg
+
+    def _translate_check_violation(self, code_msg: str, error_msg: str) -> str:
+        """Extract details from a check constraint violation and return a message.
+
+        Looks up the violated constraint in `check_map` for a custom description.
+        Falls back to `UNKNOWN_CHECK_DESCRIPTION` if not found.
+
+        Args:
+            code_msg: Base message from code_map for this error type.
+            error_msg: Full PostgreSQL error text.
+
+        Returns:
+            Formatted message with constraint name and its description if available;
+            otherwise returns the base code_msg.
+
+        Example:
+            If constraint 'age_check' is violated and check_map provides a description,
+            returns: "Нарушено ограничение данных: ключ age_check.
+            Описание: Возраст должен быть от 18 до 120"
+
+        """
+        msg = code_msg
+
+        pattern = re.compile(CHECK_VIOLATION_PATTERN)
+        matched = pattern.search(error_msg)
+        if matched is not None:
+            constraint = matched.group(1)
+            description = self.check_map.get(
+                constraint,
+                UNKNOWN_CHECK_DESCRIPTION,
+            )
+
+            if constraint and description:
+                msg = f"{code_msg}: ключ {constraint}. Описание: {description}"
+
+        return msg
+
+    def _translate_user_raise(self, code_msg: str, error_msg: str) -> str:
+        """Extract details from a user-raised exception and return a message.
+
+        Searches the error message for known field keys defined in `user_map`.
+        Returns a user-friendly description if a match is found; otherwise falls back
+        to `UNKNOWN_USER_RAISE_DESCRIPTION`.
+
+        Args:
+            code_msg: Base message from code_map for this error type.
+            error_msg: Full PostgreSQL error text from RAISE EXCEPTION.
+
+        Returns:
+            Formatted message with a friendly field description if found;
+            otherwise returns the base code_msg with a generic description.
+
+        Example:
+            If error_msg contains 'status' and user_map={"status": "Статус"},
+            returns: "Ошибка БД: Статус"
+
+            If no match is found:
+            returns: "Ошибка БД: Невозможно выполнить операцию"
+
+        """
+        description = UNKNOWN_USER_RAISE_DESCRIPTION
+
+        for key in self.user_map:
+            if key in error_msg:
+                description = self.user_map.get(key)
+                break
+
+        return f"{code_msg}: {description}"

{various_api_tools-1.0.0 → various_api_tools-2.0.0}/src/various_api_tools/translators/psycopg/constants.py

@@ -48,7 +48,23 @@ is configured.
 Used as the default value when a constraint name is not found in `check_map`.
 Displayed to users when the system cannot provide more specific validation feedback."""
 
+UNKNOWN_USER_RAISE_DESCRIPTION: Final[str] = "Невозможно выполнить операцию"
+"""Default message shown when a custom database RAISE EXCEPTION is caught,
+but no matching field or rule is found in `user_map`.
+
+Used as a fallback in `BasePsycopgTranslator._translate_user_raise`
+to avoid exposing raw internal messages to end users."""
+
+USER_RAISE_KEY: Final[str] = "Ошибка БД"
+"""Default display key used in error messages generated from RAISE EXCEPTION.
+
+Used as a generic identifier when formatting user-facing errors from custom
+database raises, especially when no specific field mapping is available.
+
+Example: '{Ошибка БД}: {описание}'"""
+
 DEFAULT_CODE_MAP: Final[dict[str, str]] = {
+    "P0001": "Ошибка БД",
     "23503": "Указан несуществующий идентификатор связанного объекта",
     "23505": "БД уже содержит значение",
     "23514": "Нарушено ограничение данных",
@@ -56,6 +72,7 @@ DEFAULT_CODE_MAP: Final[dict[str, str]] = {
 """Default mapping of PostgreSQL SQLSTATE codes to user-friendly Russian error messages.
 
 Each key is a standardized SQLSTATE code:
+    - "P0001" (raise_exception): Custom exception raised in PL/pgSQL
     - "23503" (foreign_key_violation): Referenced object does not exist
     - "23505" (unique_violation): Duplicate key value
     - "23514" (check_violation): Data fails check constraint

{various_api_tools-1.0.0 → various_api_tools-2.0.0}/tests/translators/test_psycopg.py

@@ -1,4 +1,3 @@
-from various_api_tools.translators.psycopg.base import ErrorData
 from various_api_tools.translators.psycopg.psycopg import PsycopgErrorTranslator
 
 
@@ -7,14 +6,21 @@ class TestPsycopgErrorTranslator:
         error_msg = (
             "DETAIL:  Key (uuid)=(a6cc5730-2261-11ee-9c43-2eb5a363657c) already exists."
         )
-        result = PsycopgErrorTranslator._translate_unique_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "uuid"
-        assert result.value == "a6cc5730-2261-11ee-9c43-2eb5a363657c"
+        result = PsycopgErrorTranslator._translate_unique_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert (
+            result
+            == "Ошибка БД: ключ uuid, значение a6cc5730-2261-11ee-9c43-2eb5a363657c"
+        )
 
         error_msg = "No violation here."
-        result = PsycopgErrorTranslator._translate_unique_violation(error_msg)
-        assert result is None
+        result = PsycopgErrorTranslator._translate_unique_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД"
 
     def test_translate_check_violation(self):
         translator = PsycopgErrorTranslator(
@@ -22,20 +28,27 @@ class TestPsycopgErrorTranslator:
         )
 
         error_msg = 'violates check constraint "valid_email"'
-        result = translator._translate_check_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "valid_email"
-        assert result.value == "Невалидный email"
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД: ключ valid_email. Описание: Невалидный email"
 
         error_msg = 'violates check constraint "unknown_check"'
-        result = translator._translate_check_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "unknown_check"
-        assert result.value == "Невалидная запись в БД"
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert (
+            result == "Ошибка БД: ключ unknown_check. Описание: Невалидная запись в БД"
+        )
 
         error_msg = "No violation here."
-        result = translator._translate_check_violation(error_msg)
-        assert result is None
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД"
 
     def test_translate_with_unique_violation(self):
         class MockError(Exception):
@@ -48,7 +61,7 @@ class TestPsycopgErrorTranslator:
         translator = PsycopgErrorTranslator()
         result = translator.translate(MockError())
         assert (
-            "БД уже содержит значение: ключ email, значение invalid@example.com."
+            "БД уже содержит значение: ключ email, значение invalid@example.com"
             in result
         )
 
@@ -65,7 +78,7 @@ class TestPsycopgErrorTranslator:
         )
         result = translator.translate(MockError())
         assert (
-            "Нарушено ограничение данных: ключ valid_email, значение Невалидный email."
+            "Нарушено ограничение данных: ключ valid_email. Описание: Невалидный email"
             in result
         )
 

{various_api_tools-1.0.0 → various_api_tools-2.0.0}/tests/translators/test_psycopg2.py

@@ -1,4 +1,3 @@
-from various_api_tools.translators.psycopg.base import ErrorData
 from various_api_tools.translators.psycopg.psycopg2 import Psycopg2ErrorTranslator
 
 
@@ -7,14 +6,21 @@ class TestPsycopg2ErrorTranslator:
         error_msg = (
             "DETAIL:  Key (uuid)=(a6cc5730-2261-11ee-9c43-2eb5a363657c) already exists."
         )
-        result = Psycopg2ErrorTranslator._translate_unique_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "uuid"
-        assert result.value == "a6cc5730-2261-11ee-9c43-2eb5a363657c"
+        result = Psycopg2ErrorTranslator._translate_unique_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert (
+            result
+            == "Ошибка БД: ключ uuid, значение a6cc5730-2261-11ee-9c43-2eb5a363657c"
+        )
 
         error_msg = "No violation here."
-        result = Psycopg2ErrorTranslator._translate_unique_violation(error_msg)
-        assert result is None
+        result = Psycopg2ErrorTranslator._translate_unique_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД"
 
     def test_translate_check_violation(self):
         translator = Psycopg2ErrorTranslator(
@@ -22,20 +28,27 @@ class TestPsycopg2ErrorTranslator:
         )
 
         error_msg = 'violates check constraint "valid_email"'
-        result = translator._translate_check_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "valid_email"
-        assert result.value == "Невалидный email"
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД: ключ valid_email. Описание: Невалидный email"
 
         error_msg = 'violates check constraint "unknown_check"'
-        result = translator._translate_check_violation(error_msg)
-        assert isinstance(result, ErrorData)
-        assert result.key == "unknown_check"
-        assert result.value == "Невалидная запись в БД"
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert (
+            result == "Ошибка БД: ключ unknown_check. Описание: Невалидная запись в БД"
+        )
 
         error_msg = "No violation here."
-        result = translator._translate_check_violation(error_msg)
-        assert result is None
+        result = translator._translate_check_violation(
+            code_msg="Ошибка БД",
+            error_msg=error_msg,
+        )
+        assert result == "Ошибка БД"
 
     def test_translate_with_unique_violation(self):
         class MockError(Exception):
@@ -48,8 +61,8 @@ class TestPsycopg2ErrorTranslator:
         translator = Psycopg2ErrorTranslator()
         result = translator.translate(MockError())
         assert (
-            "БД уже содержит значение: ключ email, значение invalid@example.com."
-            in result
+            result
+            == "БД уже содержит значение: ключ email, значение invalid@example.com"
         )
 
     def test_translate_with_check_violation(self):
@@ -63,8 +76,8 @@ class TestPsycopg2ErrorTranslator:
         )
         result = translator.translate(MockError())
         assert (
-            "Нарушено ограничение данных: ключ valid_email, значение Невалидный email."
-            in result
+            result
+            == "Нарушено ограничение данных: ключ valid_email. Описание: Невалидный email"
         )
 
     def test_translate_with_unknown_code(self):

various_api_tools-1.0.0/src/various_api_tools/translators/psycopg/base.py

@@ -1,229 +0,0 @@
-"""Abstract base class for translating psycopg/psycopg2 database errors.
-
-This module provides a foundation for parsing PostgreSQL error
-details (such as `pgcode` and `pgerror`) from psycopg exceptions and converting
-them into structured, human-readable error descriptions.
-It supports both `psycopg2` and `psycopg3` by abstracting access to error attributes,
-allowing concrete implementations to handle version-specific details.
-"""
-
-import re
-from dataclasses import dataclass
-from typing import Any
-
-from .constants import (
-    CHECK_VIOLATION_PATTERN,
-    DEFAULT_CODE_MAP,
-    UNIQUE_VIOLATION_PATTERN,
-    UNKNOWN_CHECK_DESCRIPTION,
-    UNKNOWN_CODE,
-)
-
-
-@dataclass
-class ErrorData:
-    """Represents structured data extracted from a database error.
-
-    Used to capture constraint details such as the violated field and
-    its conflicting value.
-
-    Attributes:
-        key: The name of the field or constraint involved in the error.
-        value: The value that caused the constraint violation.
-
-    """
-
-    key: str
-    value: Any
-
-
-class BasePsycopgTranslator:
-    """Base translator for turning psycopg errors into user-friendly messages.
-
-    Supports customizing error messages via:
-    - `code_map`: maps SQLSTATE codes to human-readable messages
-    - `check_map`: maps check constraint names to meaningful descriptions
-
-    Subclasses must implement `_get_pgcode()` and `_get_pgerror()` to support specific
-    psycopg versions (e.g., psycopg2 vs. psycopg3).
-
-    Attributes:
-        code_map (dict): Mapping from SQLSTATE codes (str) to error messages (str).
-        check_map (dict): Mapping from check constraint names (str)
-            to descriptions (str).
-
-    """
-
-    code_map: dict
-    check_map: dict
-
-    def __init__(
-        self,
-        *,
-        code_map: dict | None = None,
-        check_map: dict | None = None,
-    ) -> None:
-        """Initialize the translator with optional custom message mappings.
-
-        Args:
-            code_map: Optional mapping from SQLSTATE codes (e.g. '23505')
-                to error messages. If None, defaults to `DEFAULT_CODE_MAP`.
-            check_map: Optional mapping from check constraint names
-                to descriptive messages. If None, defaults to an empty dict.
-
-        Example:
-        ```python
-            custom_codes = {"23505": "Значение уже существует"}
-            custom_checks = {"age_check": "Возраст должен быть от 18 до 120"}
-            t = BasePsycopgTranslator(code_map=custom_codes, check_map=custom_checks)
-        ```
-
-        """
-        if code_map is not None:
-            self.code_map = code_map
-        else:
-            self.code_map = DEFAULT_CODE_MAP
-
-        if check_map is not None:
-            self.check_map = check_map
-        else:
-            self.check_map = {}
-
-    def translate(
-        self,
-        error: Any,
-    ) -> str:
-        """Translate a psycopg database error into a user-friendly message.
-
-        Extracts `pgcode` and `pgerror` from the error and formats a meaningful response
-        based on the type of constraint violation (unique, check, foreign key).
-
-        Args:
-            error: A psycopg exception (e.g. IntegrityError, DatabaseError).
-
-        Returns:
-            A formatted error message, or a fallback if no match is found.
-
-        Example:
-        ```python
-            # Given error: unique_violation on email = 'test@example.com'
-            print(translator.translate(error))
-            #> "БД уже содержит значение: ключ email, значение test@example.com"
-        ```
-
-        """
-        msg: str = UNKNOWN_CODE
-
-        pgcode = self._get_pgcode(error)
-        pgerror = self._get_pgerror(error)
-
-        if pgcode is not None:
-            code_msg: str | None = self.code_map.get(pgcode, UNKNOWN_CODE)
-            data: ErrorData | None = None
-
-            if pgcode == "23514":
-                data = self._translate_check_violation(error_msg=pgerror)
-            elif pgcode in ["23505", "23503"]:
-                data = self._translate_unique_violation(error_msg=pgerror)
-
-            if data and code_msg:
-                msg = f"{code_msg}: ключ {data.key}, значение {data.value}."
-            else:
-                msg = code_msg
-
-        return msg
-
-    def _get_pgcode(self, error: Any) -> str | None:
-        """Extract pgcode code from the error.
-
-        Must be implemented by subclasses to support specific psycopg versions.
-
-        Args:
-            error: The raw database exception.
-
-        Returns:
-            The SQLSTATE code as a string (e.g. '23505'), or None if not available.
-
-        """
-        raise NotImplementedError
-
-    def _get_pgerror(self, error: Any) -> str | None:
-        """Extract the full error message from the exception.
-
-        Must be implemented by subclasses to support specific psycopg versions.
-
-        Args:
-            error: The raw database exception.
-
-        Returns:
-            Full error message string, or None if not available.
-
-        """
-        raise NotImplementedError
-
-    @classmethod
-    def _translate_unique_violation(cls, error_msg: str) -> ErrorData:
-        """Extract field and value from a unique constraint violation error.
-
-        Uses a regex to parse the PostgreSQL
-        "DETAIL: Key (field)=(value) already exists" message.
-
-        Args:
-            error_msg: The full error text from the database.
-
-        Returns:
-            ErrorData with extracted field name and value, or None if not matched.
-
-        Example:
-        ```python
-            error_msg = "DETAIL: Key (email)=(user@example.com) already exists."
-            print(BasePsycopgTranslator._translate_unique_violation(error_msg))
-            #> ErrorData(key='email', value='user@example.com')
-        ```
-
-        """
-        data: ErrorData | None = None
-
-        pattern = re.compile(UNIQUE_VIOLATION_PATTERN)
-        matched = pattern.search(error_msg)
-
-        if matched is not None:
-            data = ErrorData(key=matched.group(2), value=matched.group(3))
-
-        return data
-
-    def _translate_check_violation(self, error_msg: str) -> ErrorData | None:
-        """Extract constraint name and description from a check constraint violation.
-
-        Looks up a human-readable description in `self.check_map`. If not found,
-        returns a default message.
-
-        Args:
-            error_msg: The full error text from the database.
-
-        Returns:
-            ErrorData with constraint name and description, or None if not matched.
-
-        Example:
-        ```python
-            error_msg = "violates check constraint 'age_check'"
-            check_map = {"age_check": "Возраст должен быть от 18 до 120"}
-            translator = BasePsycopgTranslator(check_map=check_map)
-            print(translator._translate_check_violation(error_msg))
-            #> ErrorData(key='age_check', value='Возраст должен быть от 18 до 120')
-        ```
-
-        """
-        data: ErrorData | None = None
-
-        pattern = re.compile(CHECK_VIOLATION_PATTERN)
-        matched = pattern.search(error_msg)
-        if matched is not None:
-            check_constraint = matched.group(1)
-            constraint_description = self.check_map.get(
-                check_constraint,
-                UNKNOWN_CHECK_DESCRIPTION,
-            )
-            data = ErrorData(key=check_constraint, value=constraint_description)
-
-        return data