V6.0.1 (#24)

* V6.0.1

* V6.0.1

---------

Co-authored-by: ddc <ddc@users.noreply.github.com>

Author: ddc

README.md

@@ -38,6 +38,7 @@
 - [Context Manager Support](#context-manager-support)
 - [Using With Multiple Log Levels and Files](#using-with-multiple-log-levels-and-files)
 - [Environment Variables](#env-variables-optional)
+  - [Settings Cache Management](#settings-cache-management)
 - [Flexible Configuration Options](#flexible-configuration-options)
 - [Development](#development)
   - [Create DEV Environment, Running Tests and Building Wheel](#create-dev-environment-running-tests-and-building-wheel)
@@ -285,6 +286,25 @@ LOG_ROTATE_AT_UTC=True
 LOG_ROTATE_FILE_SUFIX="%Y%m%d"
 ```
 
+## Settings Cache Management
+
+Use `get_log_settings()` to inspect current configuration and `clear_settings_cache()` to reload configuration from environment variables:
+
+```python
+from pythonLogs import get_log_settings, clear_settings_cache
+
+# Inspect current settings
+settings = get_log_settings()
+print(settings.level)      # Current log level
+print(settings.timezone)   # Current timezone
+
+# Clear cache and reload .env on next access (default)
+clear_settings_cache()
+
+# Clear cache but keep current .env values
+clear_settings_cache(reload_env=False)
+```
+
 
 
 

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,24 @@
-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, get_log_settings
 
 __all__ = (
     "BasicLog",
     "SizeRotatingLog",
     "TimedRotatingLog",
     "LogLevel",
     "RotateWhen",
+    "clear_settings_cache",
+    "get_log_settings",
 )
 
 __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 (