Source code for cadrumo.core.i18n.translatable

"""Typed translation-key primitives for localized AEAT messages.

Defines :class:`Translatable`, the string subtype imported as ``tr`` by
catalogues and diagnostic records whose importance is carried separately by
:class:`BaseSeverity`.
"""

from __future__ import annotations

from pydantic import GetCoreSchemaHandler
from pydantic_core import core_schema

from ..errors.hierarchy import pydantic_validation_boundary




class Translatable(str):
    """A strictly-typed marker for abstract i18n keys.

    Used to type-hint fields that hold translation keys rather than
    raw user-facing strings, ensuring all translatable text can be
    statically identified and routed through ``tr``.
    """

    @classmethod
    def __get_pydantic_core_schema__(
        cls,
        source_type: type[object],
        handler: GetCoreSchemaHandler,
    ) -> core_schema.CoreSchema:
        """Expose translation-key values to Pydantic as strings."""
        del source_type, handler
        return core_schema.no_info_after_validator_function(pydantic_validation_boundary(cls), core_schema.str_schema())



__all__ = ["Translatable"]