jaylog 0.2.0__tar.gz → 0.2.2__tar.gz

{jaylog-0.2.0 → jaylog-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: jaylog
-Version: 0.2.0
+Version: 0.2.2
 Summary: Customized Python logging library with file rotation and HTTP forwarding
 Author: Gpocas
 Author-email: Gpocas <gpocas01@gmail.com>

{jaylog-0.2.0 → jaylog-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jaylog"
-version = "0.2.0"
+version = "0.2.2"
 description = "Customized Python logging library with file rotation and HTTP forwarding"
 readme = "README.md"
 authors = [

{jaylog-0.2.0 → jaylog-0.2.2}/src/jaylog/logger.py

@@ -13,14 +13,39 @@ from jaylog.settings import JaylogSettings
 # Registry: name -> (logger, listener) so callers can shut down cleanly
 _registry: dict[str, tuple[logging.Logger, QueueListener]] = {}
 _shutdown_registered = False
-_default_settings: JaylogSettings | None = None
+# name (== app_name) -> settings registrada via configure()
+_settings_registry: dict[str, JaylogSettings] = {}
 
 
-def configure(settings: JaylogSettings) -> None:
-    """Configure as settings padrão globais usadas por get_logger()."""
-    global _default_settings
-    _default_settings = settings
+def configure(settings: JaylogSettings | list[JaylogSettings]) -> None:
+    """
+    Registra uma ou mais configurações de logger.
+
+    Aceita uma única ``JaylogSettings`` ou uma lista delas. Cada configuração é
+    registrada sob o seu próprio ``app_name``, permitindo vários loggers com
+    configurações diferentes no mesmo projeto::
+
+        configure(settings_order)
+        configure([settings_order, settings_billing])
+
+    Cada chamada é a "fonte da verdade" do conjunto de loggers: derruba os
+    loggers registrados anteriormente e registra apenas os informados aqui.
+    Levanta ``ValueError`` se a lista contiver ``app_name`` duplicado.
+    """
+    items = [settings] if isinstance(settings, JaylogSettings) else list(settings)
+
+    seen: set[str] = set()
+    for item in items:
+        if item.app_name in seen:
+            raise ValueError(
+                f"app_name duplicado em configure(): '{item.app_name}'"
+            )
+        seen.add(item.app_name)
+
     shutdown()
+    _settings_registry.clear()
+    for item in items:
+        _settings_registry[item.app_name] = item
 
 
 def _register_shutdown_hooks() -> None:
@@ -39,13 +64,14 @@ def _register_shutdown_hooks() -> None:
     signal.signal(signal.SIGTERM, _sigterm_handler)
 
 
-def get_logger() -> logging.Logger:
+def get_logger(name: str | None = None) -> logging.Logger:
     """
     Return a configured logger.
 
-    The logger name is read from JAYLOG_LOGGER_NAME (default: "jaylog").
-    Calling this multiple times with the same logger name returns the **same**
-    logger without re-attaching handlers.
+    O ``name`` deve ser exatamente o ``app_name`` de uma configuração registrada
+    via ``configure()``. Quando omitido, retorna o logger da **primeira**
+    configuração registrada. Chamadas repetidas com o mesmo nome retornam o
+    **mesmo** logger, sem re-anexar handlers.
 
     Architecture:
         logger  →  QueueHandler  →  Queue  →  QueueListener  →  [FileHandler, HttpHandler?]
@@ -53,12 +79,22 @@ def get_logger() -> logging.Logger:
     The QueueListener runs in a background thread so `emit()` never blocks the
     calling thread.
     """
-    if _default_settings is None:
-        settings = JaylogSettings()  # ty:ignore[missing-argument]
-    else:
-        settings = _default_settings
+    if not _settings_registry:
+        raise Exception(
+            'Não é possivel retornar uma instancia de logger sem configuração\n'
+            'use jaylog.configure() antes de jaylog.get_logger()'
+        )
+
+    if name is None:
+        name = next(iter(_settings_registry))
+    elif name not in _settings_registry:
+        disponiveis = ', '.join(_settings_registry) or '(nenhum)'
+        raise KeyError(
+            f"Nenhuma configuração registrada para '{name}'. "
+            f"Nomes disponíveis: {disponiveis}"
+        )
 
-    name = settings.app_name
+    settings = _settings_registry[name]
 
     configure_screenshot(settings.log_screenshot_enabled)
 

{jaylog-0.2.0 → jaylog-0.2.2}/src/jaylog/settings.py

@@ -17,11 +17,17 @@ class JaylogSettings(BaseSettings):
     )
 
     _env_file: str | tuple | None = None
+    _secrets_dir: str | None = None
 
-    def __init__(self, _env_file=None, **data):
-        _env_file = self.model_config.get('env_file') if _env_file is None else _env_file
-        super().__init__(_env_file=_env_file, **data)
+    def __init__(
+        self,
+        _env_file=model_config.get('env_file'),
+        _secrets_dir=model_config.get('secrets_dir'),
+        **data
+    ):
+        super().__init__(_env_file=_env_file, _secrets_dir=_secrets_dir, **data)
         object.__setattr__(self, '_env_file', _env_file)
+        object.__setattr__(self, '_secrets_dir', _secrets_dir)
 
     # App identity
     app_name: str
@@ -60,6 +66,12 @@ class JaylogSettings(BaseSettings):
         if self.secrets_dir:
             if not self.secrets_dir.exists() or not self.secrets_dir.is_dir:
                 raise ValueError('SECRETS_DIR is not valid directory')
+
+        elif self._secrets_dir != self.model_config.get('secrets_dir'):
+            raise SyntaxError(
+                'Não é possivel usar `reload_secrets` caso o valor de _secrets_dir foi sobrescrito'
+            )
+            
                 
         
         return JaylogSettings(