V6.0.1

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)
+```
+
 
 
 

pythonLogs/__init__.py

@@ -2,7 +2,7 @@
 from importlib.metadata import version
 from pythonLogs.core.constants import LogLevel, RotateWhen
 from pythonLogs.core.factory import BasicLog, SizeRotatingLog, TimedRotatingLog
-from pythonLogs.core.settings import clear_settings_cache
+from pythonLogs.core.settings import clear_settings_cache, get_log_settings
 
 __all__ = (
     "BasicLog",
@@ -11,6 +11,7 @@
     "LogLevel",
     "RotateWhen",
     "clear_settings_cache",
+    "get_log_settings",
 )
 
 __title__ = "pythonLogs"

tests/core/test_settings.py

@@ -188,17 +188,30 @@ def test_new_settings_after_env_change(self):
 
 
 class TestPublicExports:
-    """Test that clear_settings_cache is exported from main module."""
+    """Test that clear_settings_cache and get_log_settings are exported from main module."""
 
-    def test_import_from_main_module(self):
+    def test_clear_settings_cache_import_from_main_module(self):
         """Test that clear_settings_cache can be imported from pythonLogs."""
         from pythonLogs import clear_settings_cache as exported_func
         from pythonLogs.core.settings import clear_settings_cache as original_func
 
         assert exported_func is original_func
 
-    def test_in_all(self):
+    def test_clear_settings_cache_in_all(self):
         """Test that clear_settings_cache is in __all__."""
         import pythonLogs
 
         assert "clear_settings_cache" in pythonLogs.__all__
+
+    def test_get_log_settings_import_from_main_module(self):
+        """Test that get_log_settings can be imported from pythonLogs."""
+        from pythonLogs import get_log_settings as exported_func
+        from pythonLogs.core.settings import get_log_settings as original_func
+
+        assert exported_func is original_func
+
+    def test_get_log_settings_in_all(self):
+        """Test that get_log_settings is in __all__."""
+        import pythonLogs
+
+        assert "get_log_settings" in pythonLogs.__all__