pythonLogs 4.0.3__tar.gz → 4.0.5__tar.gz

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pythonLogs
-Version: 4.0.3
+Version: 4.0.5
 Summary: High-performance Python logging library with file rotation and optimized caching for better performance
 License: MIT
 Keywords: python3,python-3,python,log,logging,logger,logutils,log-utils,pythonLogs
@@ -21,7 +21,6 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: pydantic (>=2.11.7,<3.0.0)
 Requires-Dist: pydantic-settings (>=2.10.1,<3.0.0)
 Requires-Dist: python-dotenv (>=1.1.1,<2.0.0)
 Project-URL: Homepage, https://pypi.org/project/pythonLogs
@@ -58,7 +57,6 @@ High-performance Python logging library with file rotation and optimized caching
 - [Memory Management](#memory-management)
 - [Flexible Configuration Options](#flexible-configuration-options)
 - [Migration Guide](#migration-guide)
-- [Performance Improvements](#performance-improvements)
 - [Development](#source-code)
 - [Run Tests and Get Coverage Report using Poe](#run-tests-and-get-coverage-report-using-poe)
 - [License](#license)
@@ -476,40 +474,6 @@ registered = LoggerFactory.get_registered_loggers()
 print(f"Currently registered: {list(registered.keys())}")
 ```
 
-## Thread-Safe Operations
-All memory management operations are thread-safe and can be used safely in multi-threaded applications:
-
-```python
-import threading
-from pythonLogs import size_rotating_logger, clear_logger_registry
-
-def worker_function(worker_id):
-    # Each thread can safely create and use loggers
-    logger = size_rotating_logger(
-        name=f"worker_{worker_id}",
-        directory="/app/logs"
-    )
-    
-    with logger as log:
-        log.info(f"Worker {worker_id} started")
-        # Automatic cleanup per thread
-
-# Create multiple threads - all operations are thread-safe
-threads = []
-for i in range(10):
-    thread = threading.Thread(target=worker_function, args=(i,))
-    threads.append(thread)
-    thread.start()
-
-# Wait for completion and clean up
-for thread in threads:
-    thread.join()
-
-# Safe to clear registry from main thread
-clear_logger_registry()
-```
-
-
 # Flexible Configuration Options
 You can use either enums (for type safety) or strings (for simplicity):
 
@@ -582,25 +546,6 @@ timed_logger = timed_rotating_logger(level=LogLevel.WARNING, name="app", directo
 - 🔧 **Cleaner API** without manual `.init()` calls
 - 📚 **Centralized configuration** through factory pattern
 
-# Performance Improvements
-
-## Benchmarks
-The factory pattern with optimizations provides significant performance improvements:
-
-| Feature | Improvement | Benefit |
-|---------|-------------|---------|
-| Logger Registry | 90%+ faster | Cached logger instances |
-| Settings Caching | ~85% faster | Reused configuration objects |
-| Directory Validation | ~75% faster | Cached permission checks |
-| Timezone Operations | ~60% faster | Cached timezone functions |
-
-## Performance Test Results
-```python
-# Create 100 loggers - Performance comparison
-# Legacy method:     ~0.045 seconds
-# Factory pattern:   ~0.004 seconds  
-# Improvement:       91% faster ⚡
-```
 
 # Source Code
 ### Build
@@ -609,7 +554,6 @@ poetry build -f wheel
 ```
 
 
-
 # Run Tests and Get Coverage Report using Poe
 ```shell
 poetry update --with test
@@ -617,13 +561,10 @@ poe test
 ```
 
 
-
 # License
 Released under the [MIT License](LICENSE)
 
 
-
-
 # Buy me a cup of coffee
 + [GitHub Sponsor](https://github.com/sponsors/ddc)
 + [ko-fi](https://ko-fi.com/ddcsta)

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/README.md

@@ -28,7 +28,6 @@ High-performance Python logging library with file rotation and optimized caching
 - [Memory Management](#memory-management)
 - [Flexible Configuration Options](#flexible-configuration-options)
 - [Migration Guide](#migration-guide)
-- [Performance Improvements](#performance-improvements)
 - [Development](#source-code)
 - [Run Tests and Get Coverage Report using Poe](#run-tests-and-get-coverage-report-using-poe)
 - [License](#license)
@@ -446,40 +445,6 @@ registered = LoggerFactory.get_registered_loggers()
 print(f"Currently registered: {list(registered.keys())}")
 ```
 
-## Thread-Safe Operations
-All memory management operations are thread-safe and can be used safely in multi-threaded applications:
-
-```python
-import threading
-from pythonLogs import size_rotating_logger, clear_logger_registry
-
-def worker_function(worker_id):
-    # Each thread can safely create and use loggers
-    logger = size_rotating_logger(
-        name=f"worker_{worker_id}",
-        directory="/app/logs"
-    )
-    
-    with logger as log:
-        log.info(f"Worker {worker_id} started")
-        # Automatic cleanup per thread
-
-# Create multiple threads - all operations are thread-safe
-threads = []
-for i in range(10):
-    thread = threading.Thread(target=worker_function, args=(i,))
-    threads.append(thread)
-    thread.start()
-
-# Wait for completion and clean up
-for thread in threads:
-    thread.join()
-
-# Safe to clear registry from main thread
-clear_logger_registry()
-```
-
-
 # Flexible Configuration Options
 You can use either enums (for type safety) or strings (for simplicity):
 
@@ -552,25 +517,6 @@ timed_logger = timed_rotating_logger(level=LogLevel.WARNING, name="app", directo
 - 🔧 **Cleaner API** without manual `.init()` calls
 - 📚 **Centralized configuration** through factory pattern
 
-# Performance Improvements
-
-## Benchmarks
-The factory pattern with optimizations provides significant performance improvements:
-
-| Feature | Improvement | Benefit |
-|---------|-------------|---------|
-| Logger Registry | 90%+ faster | Cached logger instances |
-| Settings Caching | ~85% faster | Reused configuration objects |
-| Directory Validation | ~75% faster | Cached permission checks |
-| Timezone Operations | ~60% faster | Cached timezone functions |
-
-## Performance Test Results
-```python
-# Create 100 loggers - Performance comparison
-# Legacy method:     ~0.045 seconds
-# Factory pattern:   ~0.004 seconds  
-# Improvement:       91% faster ⚡
-```
 
 # Source Code
 ### Build
@@ -579,7 +525,6 @@ poetry build -f wheel
 ```
 
 
-
 # Run Tests and Get Coverage Report using Poe
 ```shell
 poetry update --with test
@@ -587,13 +532,10 @@ poe test
 ```
 
 
-
 # License
 Released under the [MIT License](LICENSE)
 
 
-
-
 # Buy me a cup of coffee
 + [GitHub Sponsor](https://github.com/sponsors/ddc)
 + [ko-fi](https://ko-fi.com/ddcsta)

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "pythonLogs"
-version = "4.0.3"
+version = "4.0.5"
 description = "High-performance Python logging library with file rotation and optimized caching for better performance"
 license = "MIT"
 readme = "README.md"
@@ -32,7 +32,6 @@ classifiers = [
 
 [tool.poetry.dependencies]
 python = "^3.10"
-pydantic = "^2.11.7"
 pydantic-settings = "^2.10.1"
 python-dotenv = "^1.1.1"
 

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pythonLogs/basic_log.py

@@ -1,12 +1,13 @@
 # -*- encoding: utf-8 -*-
 import logging
-import threading
 from typing import Optional
 from pythonLogs.log_utils import get_format, get_level, get_timezone_function
 from pythonLogs.memory_utils import cleanup_logger_handlers, register_logger_weakref
 from pythonLogs.settings import get_log_settings
+from pythonLogs.thread_safety import auto_thread_safe
 
 
+@auto_thread_safe(['init', '_cleanup_logger'])
 class BasicLog:
     """Basic logger with context manager support for automatic resource cleanup."""
 
@@ -27,8 +28,6 @@ class BasicLog:
         self.timezone = timezone or _settings.timezone
         self.showlocation = showlocation or _settings.show_location
         self.logger = None
-        # Instance-level lock for thread safety
-        self._lock = threading.Lock()
 
     def init(self):
         logger = logging.getLogger(self.appname)
@@ -54,8 +53,7 @@ class BasicLog:
 
     def _cleanup_logger(self, logger: logging.Logger) -> None:
         """Clean up logger resources by closing all handlers with thread safety."""
-        with self._lock:
-            cleanup_logger_handlers(logger)
+        cleanup_logger_handlers(logger)
 
     @staticmethod
     def cleanup_logger(logger: logging.Logger) -> None:

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pythonLogs/constants.py

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8 -*-
+import logging
 from enum import Enum
 
 # File and Directory Constants
@@ -40,3 +41,15 @@ class RotateWhen(str, Enum):
     SUNDAY = "W6"
     HOURLY = "H"
     DAILY = "D"
+
+
+# Level mapping for performance optimization
+LEVEL_MAP = {
+    LogLevel.DEBUG.value.lower(): logging.DEBUG,
+    LogLevel.WARNING.value.lower(): logging.WARNING,
+    LogLevel.WARN.value.lower(): logging.WARNING,
+    LogLevel.ERROR.value.lower(): logging.ERROR,
+    LogLevel.CRITICAL.value.lower(): logging.CRITICAL,
+    LogLevel.CRIT.value.lower(): logging.CRITICAL,
+    LogLevel.INFO.value.lower(): logging.INFO,
+}

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pythonLogs/log_utils.py

@@ -12,7 +12,7 @@ from functools import lru_cache
 from pathlib import Path
 from typing import Callable, Set
 from zoneinfo import ZoneInfo
-from pythonLogs.constants import DEFAULT_FILE_MODE, LogLevel
+from pythonLogs.constants import DEFAULT_FILE_MODE, LEVEL_MAP
 
 
 # Global cache for checked directories with thread safety and size limits
@@ -182,17 +182,7 @@ def get_level(level: str) -> int:
         write_stderr(f"Unable to get log level. Setting default level to: 'INFO' ({logging.INFO})")
         return logging.INFO
 
-    level_map = {
-        LogLevel.DEBUG.value.lower(): logging.DEBUG,
-        LogLevel.WARNING.value.lower(): logging.WARNING,
-        LogLevel.WARN.value.lower(): logging.WARNING,
-        LogLevel.ERROR.value.lower(): logging.ERROR,
-        LogLevel.CRITICAL.value.lower(): logging.CRITICAL,
-        LogLevel.CRIT.value.lower(): logging.CRITICAL,
-        LogLevel.INFO.value.lower(): logging.INFO,
-    }
-
-    return level_map.get(level.lower(), logging.INFO)
+    return LEVEL_MAP.get(level.lower(), logging.INFO)
 
 
 def get_log_path(directory: str, filename: str) -> str:

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pythonLogs/size_rotating.py

@@ -2,7 +2,6 @@
 import logging.handlers
 import os
 import re
-import threading
 from typing import Optional
 from pythonLogs.constants import MB_TO_BYTES
 from pythonLogs.log_utils import (
@@ -18,8 +17,10 @@ from pythonLogs.log_utils import (
 )
 from pythonLogs.memory_utils import cleanup_logger_handlers, register_logger_weakref
 from pythonLogs.settings import get_log_settings
+from pythonLogs.thread_safety import auto_thread_safe
 
 
+@auto_thread_safe(['init', '_cleanup_logger'])
 class SizeRotatingLog:
     """Size-based rotating logger with context manager support for automatic resource cleanup."""
     def __init__(
@@ -49,8 +50,6 @@ class SizeRotatingLog:
         self.streamhandler = streamhandler or _settings.stream_handler
         self.showlocation = showlocation or _settings.show_location
         self.logger = None
-        # Instance-level lock for thread safety
-        self._lock = threading.Lock()
 
     def init(self):
         check_filename_instance(self.filenames)
@@ -98,8 +97,7 @@ class SizeRotatingLog:
     
     def _cleanup_logger(self, logger: logging.Logger) -> None:
         """Clean up logger resources by closing all handlers with thread safety."""
-        with self._lock:
-            cleanup_logger_handlers(logger)
+        cleanup_logger_handlers(logger)
     
     @staticmethod
     def cleanup_logger(logger: logging.Logger) -> None:

pythonlogs-4.0.5/pythonLogs/thread_safety.py

@@ -0,0 +1,135 @@
+# -*- encoding: utf-8 -*-
+import functools
+import threading
+from typing import Any, Callable, Dict, TypeVar, Type
+
+F = TypeVar('F', bound=Callable[..., Any])
+
+
+class ThreadSafeMeta(type):
+    """Metaclass that automatically adds thread safety to class methods."""
+    
+    def __new__(mcs, name: str, bases: tuple, namespace: Dict[str, Any], **kwargs):
+        # Create the class first
+        cls = super().__new__(mcs, name, bases, namespace)
+        
+        # Add a class-level lock if not already present
+        if not hasattr(cls, '_lock'):
+            cls._lock = threading.RLock()
+        
+        # Get methods that should be thread-safe (exclude private/dunder methods)
+        thread_safe_methods = getattr(cls, '_thread_safe_methods', None)
+        if thread_safe_methods is None:
+            # Auto-detect public methods that modify state
+            thread_safe_methods = [
+                method_name for method_name in namespace
+                if (callable(getattr(cls, method_name, None)) and 
+                    not method_name.startswith('_') and
+                    method_name not in ['__enter__', '__exit__', '__init__'])
+            ]
+        
+        # Wrap each method with automatic locking
+        for method_name in thread_safe_methods:
+            if hasattr(cls, method_name):
+                original_method = getattr(cls, method_name)
+                if callable(original_method):
+                    wrapped_method = thread_safe(original_method)
+                    setattr(cls, method_name, wrapped_method)
+        
+        return cls
+
+
+def thread_safe(func: F) -> F:
+    """Decorator that automatically adds thread safety to methods."""
+    
+    @functools.wraps(func)
+    def wrapper(self, *args, **kwargs):
+        # Use instance lock if available, otherwise class lock
+        lock = getattr(self, '_lock', None)
+        if lock is None:
+            # Check if class has lock, if not create one
+            if not hasattr(self.__class__, '_lock'):
+                self.__class__._lock = threading.RLock()
+            lock = self.__class__._lock
+        
+        with lock:
+            return func(self, *args, **kwargs)
+    
+    return wrapper
+
+
+def auto_thread_safe(thread_safe_methods: list = None):
+    """Class decorator that adds automatic thread safety to specified methods."""
+    
+    def decorator(cls: Type) -> Type:
+        # Add lock to class if not present
+        if not hasattr(cls, '_lock'):
+            cls._lock = threading.RLock()
+        
+        # Store thread-safe methods list
+        if thread_safe_methods:
+            cls._thread_safe_methods = thread_safe_methods
+        
+        # Get methods to make thread-safe
+        methods_to_wrap = thread_safe_methods or [
+            method_name for method_name in dir(cls)
+            if (callable(getattr(cls, method_name, None)) and 
+                not method_name.startswith('_') and
+                method_name not in ['__enter__', '__exit__', '__init__'])
+        ]
+        
+        # Wrap each method
+        for method_name in methods_to_wrap:
+            if hasattr(cls, method_name):
+                original_method = getattr(cls, method_name)
+                if callable(original_method) and not hasattr(original_method, '_thread_safe_wrapped'):
+                    wrapped_method = thread_safe(original_method)
+                    wrapped_method._thread_safe_wrapped = True
+                    setattr(cls, method_name, wrapped_method)
+        
+        return cls
+    
+    return decorator
+
+
+class AutoThreadSafe:
+    """Base class that provides automatic thread safety for all public methods."""
+    
+    def __init__(self):
+        if not hasattr(self, '_lock'):
+            self._lock = threading.RLock()
+    
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+        
+        # Add class-level lock
+        if not hasattr(cls, '_lock'):
+            cls._lock = threading.RLock()
+        
+        # Auto-wrap public methods
+        for attr_name in dir(cls):
+            if not attr_name.startswith('_'):
+                attr = getattr(cls, attr_name)
+                if callable(attr) and not hasattr(attr, '_thread_safe_wrapped'):
+                    wrapped_attr = thread_safe(attr)
+                    wrapped_attr._thread_safe_wrapped = True
+                    setattr(cls, attr_name, wrapped_attr)
+
+
+def synchronized_method(func: F) -> F:
+    """Decorator for individual methods that need thread safety."""
+    return thread_safe(func)
+
+
+class ThreadSafeContext:
+    """Context manager for thread-safe operations."""
+    
+    def __init__(self, lock: threading.Lock):
+        self.lock = lock
+    
+    def __enter__(self):
+        self.lock.acquire()
+        return self
+    
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.lock.release()

{pythonlogs-4.0.3 → pythonlogs-4.0.5}/pythonLogs/timed_rotating.py

@@ -1,7 +1,6 @@
 # -*- encoding: utf-8 -*-
 import logging.handlers
 import os
-import threading
 from typing import Optional
 from pythonLogs.log_utils import (
     check_directory_permissions,
@@ -15,8 +14,10 @@ from pythonLogs.log_utils import (
 )
 from pythonLogs.memory_utils import cleanup_logger_handlers, register_logger_weakref
 from pythonLogs.settings import get_log_settings
+from pythonLogs.thread_safety import auto_thread_safe
 
 
+@auto_thread_safe(['init', '_cleanup_logger'])
 class TimedRotatingLog:
     """
     Time-based rotating logger with context manager support for automatic resource cleanup.
@@ -60,8 +61,6 @@ class TimedRotatingLog:
         self.showlocation = showlocation or _settings.show_location
         self.rotateatutc = rotateatutc or _settings.rotate_at_utc
         self.logger = None
-        # Instance-level lock for thread safety
-        self._lock = threading.Lock()
 
     def init(self):
         check_filename_instance(self.filenames)
@@ -107,8 +106,7 @@ class TimedRotatingLog:
 
     def _cleanup_logger(self, logger: logging.Logger) -> None:
         """Clean up logger resources by closing all handlers with thread safety."""
-        with self._lock:
-            cleanup_logger_handlers(logger)
+        cleanup_logger_handlers(logger)
 
     @staticmethod
     def cleanup_logger(logger: logging.Logger) -> None: