nlbone 0.7.30__py3-none-any.whl → 0.7.31__py3-none-any.whl

nlbone/adapters/i18n/__init__.py

@@ -1,7 +1,11 @@
 from pathlib import Path
 
+from nlbone.config.settings import get_settings
+
 from .engine import I18nAdapter
-from .loaders import JSONFileLoader
+from .loaders import JSONFileLoader, CompositeLoader
 
-translator = I18nAdapter(loader=JSONFileLoader(locales_path=Path(__file__).parent.joinpath("./locales").__str__()),
-                         default_locale="fa")
+loader = CompositeLoader()
+loader.add_loader(JSONFileLoader(locales_path=Path(__file__).parent.joinpath("./locales").__str__()))
+JSONFileLoader(locales_path=lambda: get_settings().PROJECT_LOCALE_PATH)
+translator = I18nAdapter(loader=loader, default_locale="fa-IR")

nlbone/adapters/i18n/engine.py

@@ -7,12 +7,19 @@ from .loaders import BaseLoader
 
 
 class I18nAdapter(TranslationPort):
-    def __init__(self, loader: BaseLoader, default_locale: str = "fa"):
+    def __init__(self, loader: BaseLoader, default_locale: str = "fa-IR"):
         self.default_locale = default_locale
-        self._translations: Dict[str, Dict[str, str]] = loader.load()
+        self.loader = loader
+        self._translations: Optional[Dict[str, Dict[str, str]]] = None
+
+    def _ensure_loaded(self):
+        if self._translations is None:
+            self._translations = self.loader.load()
 
     def translate(self, key: str, locale: Optional[str] = None, **kwargs) -> str:
-        target_locale = locale or get_locale() or self.default_locale
+        self._ensure_loaded()
+
+        target_locale = locale or self.default_locale
 
         locale_data = self._translations.get(target_locale, {})
         text = locale_data.get(key)

nlbone/adapters/i18n/loaders.py

@@ -2,7 +2,7 @@ import json
 import logging
 from abc import ABC, abstractmethod
 from pathlib import Path
-from typing import Any, Dict
+from typing import Any, Dict, List, Callable, Union
 
 logger = logging.getLogger(__name__)
 
@@ -13,33 +13,38 @@ class BaseLoader(ABC):
         pass
 
 
+from typing import Callable, Union
+
+
 class JSONFileLoader(BaseLoader):
-    def __init__(self, locales_path: str):
-        self.locales_path = locales_path
+    def __init__(self, locales_path: Union[str, Callable[[], str]]):
+        self.locales_path_provider = locales_path
 
     def load(self) -> Dict[str, Dict[str, str]]:
         translations: Dict[str, Dict[str, str]] = {}
 
-        path_obj = Path(self.locales_path)
+        if callable(self.locales_path_provider):
+            path_str = self.locales_path_provider()
+        else:
+            path_str = self.locales_path_provider
+
+        if not path_str:
+            return translations
+
+        path_obj = Path(path_str)
 
         if not path_obj.exists():
-            logger.warning(f"Locales directory not found at: {self.locales_path}")
             return translations
 
         for file_path in path_obj.glob("*.json"):
             try:
                 lang_code = file_path.stem
-
                 with open(file_path, "r", encoding="utf-8") as f:
                     data = json.load(f)
 
                 flat_data = self._flatten_dict(data)
                 translations[lang_code] = flat_data
 
-                logger.info(f"Loaded locale '{lang_code}' with {len(flat_data)} keys.")
-
-            except json.JSONDecodeError as e:
-                logger.error(f"Invalid JSON format in {file_path}: {e}")
             except Exception as e:
                 logger.error(f"Error loading locale {file_path}: {e}")
 
@@ -49,10 +54,28 @@ class JSONFileLoader(BaseLoader):
         items = []
         for k, v in d.items():
             new_key = f"{parent_key}{sep}{k}" if parent_key else k
-
             if isinstance(v, dict):
                 items.extend(self._flatten_dict(v, new_key, sep=sep).items())
             else:
                 items.append((new_key, str(v)))
-
         return dict(items)
+
+
+class CompositeLoader(BaseLoader):
+    def __init__(self):
+        self.loaders = []
+
+    def add_loader(self, loader: BaseLoader):
+        self.loaders.append(loader)
+
+    def load(self) -> Dict[str, Dict[str, str]]:
+        merged_translations: Dict[str, Dict[str, str]] = {}
+
+        for loader in self.loaders:
+            data = loader.load()
+            for lang, keys in data.items():
+                if lang not in merged_translations:
+                    merged_translations[lang] = {}
+                merged_translations[lang].update(keys)
+
+        return merged_translations

nlbone/adapters/i18n/locales/fa-IR.json

@@ -1,11 +1,4 @@
 {
-  "general": {
-    "welcome": "خوش آمدید",
-    "buttons": {
-      "save": "ذخیره",
-      "cancel": "لغو"
-    }
-  },
   "auth": {
     "otp_sent": "کد تایید برای {mobile} ارسال شد."
   },

nlbone/config/settings.py

@@ -113,6 +113,8 @@ class Settings(BaseSettings):
     RABBITMQ_TICKETING_EXCHANGE: str = "crm_stage.ticket"
     RABBITMQ_TICKETING_ROUTING_KEY_CREATE_V1: str = "crm_stage.ticket.create.v1"
 
+    PROJECT_LOCALE_PATH: str = ""
+
     model_config = SettingsConfigDict(
         env_prefix="",
         env_file=None,

{nlbone-0.7.30.dist-info → nlbone-0.7.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nlbone
-Version: 0.7.30
+Version: 0.7.31
 Summary: Backbone package for interfaces and infrastructure in Python projects
 Author-email: Amir Hosein Kahkbazzadeh <a.khakbazzadeh@gmail.com>
 License: MIT

{nlbone-0.7.30.dist-info → nlbone-0.7.31.dist-info}/RECORD

@@ -30,10 +30,10 @@ nlbone/adapters/http_clients/pricing/pricing_service.py,sha256=_15vyEwJD3S2DJG-y
 nlbone/adapters/http_clients/uploadchi/__init__.py,sha256=uBzEOuVtY22teWW2b36Pitkdk5yVdSqa6xbg22JfTNg,105
 nlbone/adapters/http_clients/uploadchi/uploadchi.py,sha256=erpjOees25FW0nuK1PkYS-oU0h8MeRV9Rhs1cf3gaEs,4881
 nlbone/adapters/http_clients/uploadchi/uploadchi_async.py,sha256=PQbVNeaYde5CmgT3vcnQoI1PGeSs9AxHlPFuB8biOmU,4717
-nlbone/adapters/i18n/__init__.py,sha256=19C_u8ZzWLQRfhG96FmEyk9x3pP9Iv8yEk59Or7UMU8,257
-nlbone/adapters/i18n/engine.py,sha256=f_nxxy-_T5CITnPp3vnxBl0hZZ8MSn0aA-PzajSx_dQ,908
-nlbone/adapters/i18n/loaders.py,sha256=Qz2B8YFaYx8u5OusO4Vo2zCwvnnVfTH7fetAOJZiK3c,1778
-nlbone/adapters/i18n/locales/fa-IR.json,sha256=SMShgJErN-tDLOSH3hAsjg08O8GPlDfDVyFGjIUQpGU,340
+nlbone/adapters/i18n/__init__.py,sha256=fS97TR7HEc7fiDC2ufQKoFOxXDNkGA4njAFIB3EmhLk,426
+nlbone/adapters/i18n/engine.py,sha256=55DbbVPPHG64o640BzWDsjaxRfu6GykZzVBqME03iDE,1078
+nlbone/adapters/i18n/loaders.py,sha256=7td0Cmn0ehjDO2S2qeH31zwl8UyWI7quzedP9PnPhWk,2381
+nlbone/adapters/i18n/locales/fa-IR.json,sha256=QL4XSuSIL82wYhBrvyOAoMM0rG9yjKuOue43_YItuSM,208
 nlbone/adapters/messaging/__init__.py,sha256=o6ZiMihm_MhRXfcEpcjHBB3JGQovQbg3pxe0qS6516c,41
 nlbone/adapters/messaging/event_bus.py,sha256=MSM70JPHoDK17efWlh20ATT1O0KW7xWnwZ5D-gI6U_w,3773
 nlbone/adapters/messaging/rabbitmq.py,sha256=Io3flSj8DMIHExJguh3hDgWT4LuDoPYb_xmQQ3k47Cs,1894
@@ -47,7 +47,7 @@ nlbone/adapters/ticketing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 nlbone/adapters/ticketing/client.py,sha256=J1-eT3qQDAJqrHcVpP1oqWNsRNnJ54dDdBeez-m9wyY,1291
 nlbone/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/config/logging.py,sha256=Ot6Ctf7EQZlW8YNB-uBdleqI6wixn5fH0Eo6QRgNkQk,4358
-nlbone/config/settings.py,sha256=2Kx7RZ7IwqTNTKB_0jLxy6G-qkeTWKGVqohLIIwA1DU,4750
+nlbone/config/settings.py,sha256=vOB8RQ5iBdbRpvcbBF7Cdpr9IwdarrHPz-ncQ_yQA8g,4785
 nlbone/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/base_worker.py,sha256=5brIToSd-vi6tw0ukhHnUZGZhOLq1SQ-NRRy-kp6D24,1193
@@ -114,8 +114,8 @@ nlbone/utils/http.py,sha256=0yeI34j5FfelqvX3PJnKknSXji1jl15VYbVIIvrSbXg,997
 nlbone/utils/normalize_mobile.py,sha256=sGH4tV9gX-6eVKozviNWJhm1DN1J28Nj-ERldCYkS_E,732
 nlbone/utils/redactor.py,sha256=-V4HrHmHwPi3Kez587Ek1uJlgK35qGSrwBOvcbw8Jas,1279
 nlbone/utils/time.py,sha256=DjjyQ9GLsfXoT6NK8RDW2rOlJg3e6sF04Jw6PBUrSvg,1268
-nlbone-0.7.30.dist-info/METADATA,sha256=1Mt2PMc8gNgSKNuHrH-LjPnQ3k2b7yiK67r4n_7yXqA,2295
-nlbone-0.7.30.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-nlbone-0.7.30.dist-info/entry_points.txt,sha256=CpIL45t5nbhl1dGQPhfIIDfqqak3teK0SxPGBBr7YCk,59
-nlbone-0.7.30.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone-0.7.30.dist-info/RECORD,,
+nlbone-0.7.31.dist-info/METADATA,sha256=18DKVQix7O0AX3SAPyjkekbvQpeNzlizIQ0KVPW3E8s,2295
+nlbone-0.7.31.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+nlbone-0.7.31.dist-info/entry_points.txt,sha256=CpIL45t5nbhl1dGQPhfIIDfqqak3teK0SxPGBBr7YCk,59
+nlbone-0.7.31.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone-0.7.31.dist-info/RECORD,,