V6.0.1

Author: ddc

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pythonLogs"
-version = "6.0.0"
+version = "6.0.1"
 description = "High-performance Python logging library with file rotation and optimized caching for better performance"
 license = {text = "MIT"}
 readme = "README.md"
@@ -30,7 +30,7 @@ classifiers = [
 ]
 requires-python = ">=3.12"
 dependencies = [
-    "pydantic-settings>=2.12.0",
+    "pydantic-settings>=2.11.0",
 ]
 
 [project.urls]
@@ -40,7 +40,7 @@ Repository = "https://github.com/ddc/pythonLogs"
 [project.optional-dependencies]
 test = [
     "poethepoet>=0.40.0",
-    "psutil>=7.2.1",
+    "psutil>=7.2.2",
     "pytest>=9.0.2",
     "pytest-cov>=7.0.0",
 ]
@@ -54,7 +54,7 @@ packages = ["pythonLogs"]
 [tool.poe.tasks]
 build = "uv build --wheel"
 updatedev.shell = "uv lock && uv sync --no-install-project --all-extras"
-linter.shell = "uv run ruff check --fix --select I . && uv run black ."
+linter.shell = "uv run ruff check --fix . && uv run black ."
 profile = "uv run python -m cProfile -o cprofile.prof -m pytest"
 test = "uv run pytest"
 
@@ -97,9 +97,20 @@ skip-string-normalization = true
 line-length = 120
 
 [tool.ruff.lint]
-select = ["I"]
+# I - Import sorting and organization
+# F401 - Detect and remove unused imports
+select = ["I", "F401"]
 
 [tool.ruff.lint.isort]
 known-first-party = ["pythonLogs"]
-force-sort-within-sections = true
+force-sort-within-sections = false
+from-first = false
 no-sections = true
+
+[tool.ruff.lint.per-file-ignores]
+# S101 Use of `assert` detected
+# S105 Possible hardcoded password assigned to variable
+# S106 Possible hardcoded password assigned to argument
+# S311 Standard pseudo-random generators are not suitable for cryptographic purposes
+# SLF001 Private member accessed
+"tests/**/*.py" = ["S101", "S105", "S106", "S311", "SLF001"]

pythonLogs/__init__.py

@@ -1,63 +1,23 @@
-from importlib.metadata import version
 import logging
+from importlib.metadata import version
 from pythonLogs.core.constants import LogLevel, RotateWhen
 from pythonLogs.core.factory import BasicLog, SizeRotatingLog, TimedRotatingLog
-from typing import Literal, NamedTuple
+from pythonLogs.core.settings import clear_settings_cache
 
 __all__ = (
     "BasicLog",
     "SizeRotatingLog",
     "TimedRotatingLog",
     "LogLevel",
     "RotateWhen",
+    "clear_settings_cache",
 )
 
 __title__ = "pythonLogs"
 __author__ = "Daniel Costa"
-__email__ = "danieldcsta@gmail.com>"
+__email__ = "danieldcsta@gmail.com"
 __license__ = "MIT"
 __copyright__ = "Copyright 2024-present DDC Softwares"
-_req_python_version = (3, 12, 0)
-
-
-try:
-    _version = tuple(int(x) for x in version(__title__).split("."))
-except ModuleNotFoundError:
-    _version = (0, 0, 0)
-
-
-class VersionInfo(NamedTuple):
-    major: int
-    minor: int
-    micro: int
-    releaselevel: Literal["alpha", "beta", "candidate", "final"]
-    serial: int
-
-
-__version__ = _version
-__version_info__: VersionInfo = VersionInfo(
-    major=__version__[0],
-    minor=__version__[1],
-    micro=__version__[2],
-    releaselevel="final",
-    serial=0,
-)
-__req_python_version__: VersionInfo = VersionInfo(
-    major=_req_python_version[0],
-    minor=_req_python_version[1],
-    micro=_req_python_version[2],
-    releaselevel="final",
-    serial=0,
-)
+__version__ = version(__title__)
 
 logging.getLogger(__name__).addHandler(logging.NullHandler())
-
-del (
-    logging,
-    NamedTuple,
-    Literal,
-    VersionInfo,
-    version,
-    _version,
-    _req_python_version,
-)

pythonLogs/core/constants.py

@@ -1,5 +1,5 @@
-from enum import Enum
 import logging
+from enum import Enum
 
 # File and Directory Constants
 MB_TO_BYTES = 1024 * 1024

pythonLogs/core/factory.py

@@ -1,15 +1,15 @@
 import atexit
+import logging
+import threading
+import time
 from dataclasses import dataclass
 from enum import Enum
-import logging
 from pythonLogs.basic_log import BasicLog as _BasicLogImpl
 from pythonLogs.core.constants import LogLevel, RotateWhen
 from pythonLogs.core.log_utils import cleanup_logger_handlers
 from pythonLogs.core.settings import get_log_settings
 from pythonLogs.size_rotating import SizeRotatingLog as _SizeRotatingLogImpl
 from pythonLogs.timed_rotating import TimedRotatingLog as _TimedRotatingLogImpl
-import threading
-import time
 from typing import Dict, Optional, Tuple, Union, assert_never
 
 

pythonLogs/core/log_utils.py

@@ -1,17 +1,17 @@
-from datetime import datetime, timedelta
-from datetime import timezone as dttz
 import errno
-from functools import lru_cache
 import gzip
 import logging
 import logging.handlers
 import os
-from pathlib import Path
-from pythonLogs.core.constants import DEFAULT_FILE_MODE, LEVEL_MAP
 import shutil
 import sys
 import threading
 import time
+from datetime import datetime, timedelta
+from datetime import timezone as dttz
+from functools import lru_cache
+from pathlib import Path
+from pythonLogs.core.constants import DEFAULT_FILE_MODE, LEVEL_MAP
 from typing import Callable, Optional, Set
 from zoneinfo import ZoneInfo
 

pythonLogs/core/memory_utils.py

@@ -1,9 +1,9 @@
-from . import log_utils
-from functools import lru_cache
 import logging
 import threading
-from typing import Any, Dict, Optional, Set
 import weakref
+from . import log_utils
+from functools import lru_cache
+from typing import Any, Dict, Optional, Set
 
 # Formatter cache to reduce memory usage for identical formatters
 _formatter_cache: Dict[str, logging.Formatter] = {}

pythonLogs/core/settings.py

@@ -16,6 +16,14 @@
 _dotenv_loaded = False
 
 
+def _ensure_dotenv_loaded() -> None:
+    """Ensure dotenv is loaded only once."""
+    global _dotenv_loaded
+    if not _dotenv_loaded:
+        load_dotenv()
+        _dotenv_loaded = True
+
+
 class LogSettings(BaseSettings):
     """If any ENV variable is omitted, it falls back to default values here"""
 
@@ -95,9 +103,18 @@ class LogSettings(BaseSettings):
 
 @lru_cache(maxsize=1)
 def get_log_settings() -> LogSettings:
-    """Get cached log settings instance to avoid repeated instantiation"""
-    global _dotenv_loaded
-    if not _dotenv_loaded:
-        load_dotenv()
-        _dotenv_loaded = True
+    """Get cached log settings instance to avoid repeated instantiation."""
+    _ensure_dotenv_loaded()
     return LogSettings()
+
+
+def clear_settings_cache(reload_env: bool = True) -> None:
+    """Clear log settings cache. Next call to get_log_settings() will create fresh instance.
+
+    Args:
+        reload_env: If True, also reset dotenv loaded flag to reload .env on next access
+    """
+    global _dotenv_loaded
+    get_log_settings.cache_clear()
+    if reload_env:
+        _dotenv_loaded = False

pythonLogs/size_rotating.py

@@ -1,5 +1,6 @@
 import logging.handlers
 import os
+import re
 from pathlib import Path
 from pythonLogs.core.constants import MB_TO_BYTES
 from pythonLogs.core.log_utils import (
@@ -17,7 +18,6 @@
 from pythonLogs.core.memory_utils import register_logger_weakref
 from pythonLogs.core.settings import get_log_settings
 from pythonLogs.core.thread_safety import auto_thread_safe
-import re
 
 
 @auto_thread_safe(['init'])

tests/context_management/test_resource_management.py

@@ -12,9 +12,7 @@
 
 import pytest
 from pythonLogs import (
-    BasicLog,
     LogLevel,
-    SizeRotatingLog,
 )
 from pythonLogs.basic_log import BasicLog as BasicLogImpl
 from pythonLogs.core.factory import (

tests/core/test_log_utils.py

@@ -2,7 +2,6 @@
 """Utility functions and tests for log_utils module."""
 
 import contextlib
-from contextlib import contextmanager
 import functools
 import io
 import logging
@@ -11,6 +10,7 @@
 import sys
 import tempfile
 import time
+from contextlib import contextmanager
 
 # Add parent directory to path for imports
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
@@ -27,24 +27,24 @@
 
 
 def skip_if_no_zoneinfo_utc():
-    """Skip test if zoneinfo or UTC timezone data is not available (common on Windows)."""
-    try:
-        from zoneinfo import ZoneInfo
+    """Skip test if UTC timezone data is not available (common on Windows without tzdata)."""
+    from zoneinfo import ZoneInfo
 
-        ZoneInfo("UTC")  # Test if UTC is available
-    except Exception:
-        pytest.skip("zoneinfo not available or UTC timezone data missing on this system")
+    try:
+        ZoneInfo("UTC")  # Test if UTC timezone data is available
+    except KeyError:
+        pytest.skip("UTC timezone data missing on this system (install tzdata package)")
 
 
 def get_safe_timezone():
     """Get a timezone that works on all platforms."""
-    try:
-        from zoneinfo import ZoneInfo
+    from zoneinfo import ZoneInfo
 
-        ZoneInfo("UTC")  # Test if UTC is available
+    try:
+        ZoneInfo("UTC")  # Test if UTC timezone data is available
         return "UTC"
-    except Exception:
-        return "localtime"  # Fallback to localtime which should always work
+    except KeyError:
+        return "localtime"  # Fallback to localtime if UTC timezone data is missing
 
 
 def requires_zoneinfo_utc(func):
@@ -60,16 +60,15 @@ def wrapper(*args, **kwargs):
 
 def requires_zoneinfo(timezone):
     """Decorator to skip tests that require a specific timezone."""
+    from zoneinfo import ZoneInfo
 
     def decorator(func):
         @functools.wraps(func)
         def wrapper(*args, **kwargs):
             try:
-                from zoneinfo import ZoneInfo
-
-                ZoneInfo(timezone)  # Test if timezone is available
-            except Exception:
-                pytest.skip(f"Timezone '{timezone}' not available on this system")
+                ZoneInfo(timezone)  # Test if timezone data is available
+            except KeyError:
+                pytest.skip(f"Timezone '{timezone}' data not available on this system")
             return func(*args, **kwargs)
 
         return wrapper
@@ -79,13 +78,13 @@ def wrapper(*args, **kwargs):
 
 def patch_logger_kwargs_with_safe_timezone(kwargs):
     """Patch logger kwargs to use safe timezone if UTC is specified but not available."""
+    from zoneinfo import ZoneInfo
+
     if kwargs.get('timezone') == 'UTC':
         try:
-            from zoneinfo import ZoneInfo
-
-            ZoneInfo("UTC")  # Test if UTC is available
-        except Exception:
-            kwargs['timezone'] = 'localtime'  # Fall back to localtime
+            ZoneInfo("UTC")  # Test if UTC timezone data is available
+        except KeyError:
+            kwargs['timezone'] = 'localtime'  # Fall back to localtime if UTC data is missing
     return kwargs
 
 
@@ -877,8 +876,8 @@ def test_remove_old_logs_file_error(self):
     def test_remove_old_logs_directory_error(self):
         """Test remove_old_logs error handling when directory scan fails"""
         # Test with a simulated Path.glob() error by mocking pathlib.Path
-        from pathlib import Path
         import unittest.mock
+        from pathlib import Path
 
         with tempfile.TemporaryDirectory() as temp_dir:
             # Create a normal directory first
@@ -1455,8 +1454,8 @@ def test_gzip_file_source_deletion_error_coverage(self):
                 f.write("test content")
 
             # Mock Path.unlink to raise OSError during deletion
-            from pathlib import Path
             import unittest.mock
+            from pathlib import Path
 
             original_unlink = Path.unlink