pythonLogs 4.0.1__tar.gz → 4.0.3__tar.gz

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: pythonLogs
-Version: 4.0.1
-Summary: A modern, high-performance Python logging library with automatic file rotation, factory pattern for easy logger creation, and optimized caching for better performance.
+Version: 4.0.3
+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
 Author: Daniel Costa
@@ -21,6 +21,7 @@ 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
@@ -40,7 +41,7 @@ Description-Content-Type: text/markdown
 
 [![Support me on GitHub](https://img.shields.io/badge/Support_me_on_GitHub-154c79?style=for-the-badge&logo=github)](https://github.com/sponsors/ddc)
 
-A modern, high-performance Python logging library with automatic file rotation, context manager support, and memory optimization.
+High-performance Python logging library with file rotation and optimized caching for better performance
 
 
 ## Table of Contents
@@ -53,11 +54,15 @@ A modern, high-performance Python logging library with automatic file rotation,
   - [Timed Rotating Logger](#timed-rotating-logger)
 - [Context Manager Support](#context-manager-support)
 - [Advanced Factory Features](#advanced-factory-features)
+- [Environment Variables](#env-variables-optional--production)
 - [Memory Management](#memory-management)
+- [Flexible Configuration Options](#flexible-configuration-options)
 - [Migration Guide](#migration-guide)
 - [Performance Improvements](#performance-improvements)
-- [Environment Variables](#env-variables-optional)
 - [Development](#source-code)
+- [Run Tests and Get Coverage Report using Poe](#run-tests-and-get-coverage-report-using-poe)
+- [License](#license)
+- [Buy me a cup of coffee](#buy-me-a-cup-of-coffee)
 
 
 
@@ -263,6 +268,7 @@ logger.warning("This is a warning example")
 
 # Context Manager Support
 
+Slow, but if you want immediate, deterministic cleanup for a specific scope.\
 All logger types support context managers for automatic resource cleanup and exception safety:
 
 ## Basic Usage
@@ -332,44 +338,6 @@ assert logger1 is logger2
 clear_logger_registry()
 ```
 
-## Flexible Configuration Options
-You can use either enums (for type safety) or strings (for simplicity):
-
-```python
-from pythonLogs import LogLevel, RotateWhen, LoggerType
-
-# Option 1: Type-safe enums (recommended)
-LogLevel.DEBUG     # "DEBUG"
-LogLevel.INFO      # "INFO"  
-LogLevel.WARNING   # "WARNING"
-LogLevel.ERROR     # "ERROR"
-LogLevel.CRITICAL  # "CRITICAL"
-
-# Option 2: String values (case-insensitive)
-"debug"       # Same as LogLevel.DEBUG
-"info"        # Same as LogLevel.INFO
-"warning"     # Same as LogLevel.WARNING  
-"warn"        # Same as LogLevel.WARN (alias)
-"error"       # Same as LogLevel.ERROR
-"critical"    # Same as LogLevel.CRITICAL
-"crit"        # Same as LogLevel.CRIT (alias)
-# Also supports: "DEBUG", "Info", "Warning", etc.
-
-# RotateWhen values
-RotateWhen.MIDNIGHT   # "midnight"
-RotateWhen.HOURLY     # "H"
-RotateWhen.DAILY      # "D"
-RotateWhen.MONDAY     # "W0"
-# ... through SUNDAY  # "W6"
-# String equivalents: "midnight", "H", "D", "W0"-"W6"
-
-# LoggerType values
-LoggerType.BASIC            # "basic"
-LoggerType.SIZE_ROTATING    # "size_rotating"  
-LoggerType.TIMED_ROTATING   # "timed_rotating"
-# String equivalents: "basic", "size_rotating", "timed_rotating"
-```
-
 ## Production Setup Example
 ```python
 from pythonLogs import size_rotating_logger, timed_rotating_logger, LogLevel, RotateWhen
@@ -413,18 +381,28 @@ error_logger.error("Database connection failed")
 audit_logger.info("User admin logged in")
 ```
 
-## Env Variables (Optional)
+## Env Variables (Optional | Production)
+The .env variables file can be used by leaving all options blank when calling the function.\
+If not specified inside the .env file, it will use the dafault value.\
+This is a good approach for production environments, since options can be changed easily.
+```python
+from pythonLogs import timed_rotating_logger
+log = timed_rotating_logger()
+```
+
 ```
 LOG_LEVEL=DEBUG
-LOG_TIMEZONE=America/Chicago
+LOG_TIMEZONE=UTC
 LOG_ENCODING=UTF-8
 LOG_APPNAME=app
 LOG_FILENAME=app.log
 LOG_DIRECTORY=/app/logs
 LOG_DAYS_TO_KEEP=30
+LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
 LOG_STREAM_HANDLER=True
 LOG_SHOW_LOCATION=False
-LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
+LOG_MAX_LOGGERS=50
+LOG_LOGGER_TTL_SECONDS=1800
 
 # SizeRotatingLog
 LOG_MAX_FILE_SIZE_MB=10
@@ -432,11 +410,10 @@ LOG_MAX_FILE_SIZE_MB=10
 # TimedRotatingLog
 LOG_ROTATE_WHEN=midnight
 LOG_ROTATE_AT_UTC=True
+LOG_ROTATE_FILE_SUFIX="%Y%m%d"
 ```
 
 
-
-
 # Memory Management
 
 The library includes comprehensive memory management features to prevent memory leaks and optimize resource usage:
@@ -533,6 +510,45 @@ clear_logger_registry()
 ```
 
 
+# Flexible Configuration Options
+You can use either enums (for type safety) or strings (for simplicity):
+
+```python
+from pythonLogs import LogLevel, RotateWhen, LoggerType
+
+# Option 1: Type-safe enums (recommended)
+LogLevel.DEBUG     # "DEBUG"
+LogLevel.INFO      # "INFO"  
+LogLevel.WARNING   # "WARNING"
+LogLevel.ERROR     # "ERROR"
+LogLevel.CRITICAL  # "CRITICAL"
+
+# Option 2: String values (case-insensitive)
+"debug"       # Same as LogLevel.DEBUG
+"info"        # Same as LogLevel.INFO
+"warning"     # Same as LogLevel.WARNING  
+"warn"        # Same as LogLevel.WARN (alias)
+"error"       # Same as LogLevel.ERROR
+"critical"    # Same as LogLevel.CRITICAL
+"crit"        # Same as LogLevel.CRIT (alias)
+# Also supports: "DEBUG", "Info", "Warning", etc.
+
+# RotateWhen values
+RotateWhen.MIDNIGHT   # "midnight"
+RotateWhen.HOURLY     # "H"
+RotateWhen.DAILY      # "D"
+RotateWhen.MONDAY     # "W0"
+# ... through SUNDAY  # "W6"
+# String equivalents: "midnight", "H", "D", "W0"-"W6"
+
+# LoggerType values
+LoggerType.BASIC            # "basic"
+LoggerType.SIZE_ROTATING    # "size_rotating"  
+LoggerType.TIMED_ROTATING   # "timed_rotating"
+# String equivalents: "basic", "size_rotating", "timed_rotating"
+```
+
+
 # Migration Guide
 
 ## Upgrading from Legacy to Factory Pattern

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

@@ -11,7 +11,7 @@
 
 [![Support me on GitHub](https://img.shields.io/badge/Support_me_on_GitHub-154c79?style=for-the-badge&logo=github)](https://github.com/sponsors/ddc)
 
-A modern, high-performance Python logging library with automatic file rotation, context manager support, and memory optimization.
+High-performance Python logging library with file rotation and optimized caching for better performance
 
 
 ## Table of Contents
@@ -24,11 +24,15 @@ A modern, high-performance Python logging library with automatic file rotation,
   - [Timed Rotating Logger](#timed-rotating-logger)
 - [Context Manager Support](#context-manager-support)
 - [Advanced Factory Features](#advanced-factory-features)
+- [Environment Variables](#env-variables-optional--production)
 - [Memory Management](#memory-management)
+- [Flexible Configuration Options](#flexible-configuration-options)
 - [Migration Guide](#migration-guide)
 - [Performance Improvements](#performance-improvements)
-- [Environment Variables](#env-variables-optional)
 - [Development](#source-code)
+- [Run Tests and Get Coverage Report using Poe](#run-tests-and-get-coverage-report-using-poe)
+- [License](#license)
+- [Buy me a cup of coffee](#buy-me-a-cup-of-coffee)
 
 
 
@@ -234,6 +238,7 @@ logger.warning("This is a warning example")
 
 # Context Manager Support
 
+Slow, but if you want immediate, deterministic cleanup for a specific scope.\
 All logger types support context managers for automatic resource cleanup and exception safety:
 
 ## Basic Usage
@@ -303,44 +308,6 @@ assert logger1 is logger2
 clear_logger_registry()
 ```
 
-## Flexible Configuration Options
-You can use either enums (for type safety) or strings (for simplicity):
-
-```python
-from pythonLogs import LogLevel, RotateWhen, LoggerType
-
-# Option 1: Type-safe enums (recommended)
-LogLevel.DEBUG     # "DEBUG"
-LogLevel.INFO      # "INFO"  
-LogLevel.WARNING   # "WARNING"
-LogLevel.ERROR     # "ERROR"
-LogLevel.CRITICAL  # "CRITICAL"
-
-# Option 2: String values (case-insensitive)
-"debug"       # Same as LogLevel.DEBUG
-"info"        # Same as LogLevel.INFO
-"warning"     # Same as LogLevel.WARNING  
-"warn"        # Same as LogLevel.WARN (alias)
-"error"       # Same as LogLevel.ERROR
-"critical"    # Same as LogLevel.CRITICAL
-"crit"        # Same as LogLevel.CRIT (alias)
-# Also supports: "DEBUG", "Info", "Warning", etc.
-
-# RotateWhen values
-RotateWhen.MIDNIGHT   # "midnight"
-RotateWhen.HOURLY     # "H"
-RotateWhen.DAILY      # "D"
-RotateWhen.MONDAY     # "W0"
-# ... through SUNDAY  # "W6"
-# String equivalents: "midnight", "H", "D", "W0"-"W6"
-
-# LoggerType values
-LoggerType.BASIC            # "basic"
-LoggerType.SIZE_ROTATING    # "size_rotating"  
-LoggerType.TIMED_ROTATING   # "timed_rotating"
-# String equivalents: "basic", "size_rotating", "timed_rotating"
-```
-
 ## Production Setup Example
 ```python
 from pythonLogs import size_rotating_logger, timed_rotating_logger, LogLevel, RotateWhen
@@ -384,18 +351,28 @@ error_logger.error("Database connection failed")
 audit_logger.info("User admin logged in")
 ```
 
-## Env Variables (Optional)
+## Env Variables (Optional | Production)
+The .env variables file can be used by leaving all options blank when calling the function.\
+If not specified inside the .env file, it will use the dafault value.\
+This is a good approach for production environments, since options can be changed easily.
+```python
+from pythonLogs import timed_rotating_logger
+log = timed_rotating_logger()
+```
+
 ```
 LOG_LEVEL=DEBUG
-LOG_TIMEZONE=America/Chicago
+LOG_TIMEZONE=UTC
 LOG_ENCODING=UTF-8
 LOG_APPNAME=app
 LOG_FILENAME=app.log
 LOG_DIRECTORY=/app/logs
 LOG_DAYS_TO_KEEP=30
+LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
 LOG_STREAM_HANDLER=True
 LOG_SHOW_LOCATION=False
-LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
+LOG_MAX_LOGGERS=50
+LOG_LOGGER_TTL_SECONDS=1800
 
 # SizeRotatingLog
 LOG_MAX_FILE_SIZE_MB=10
@@ -403,11 +380,10 @@ LOG_MAX_FILE_SIZE_MB=10
 # TimedRotatingLog
 LOG_ROTATE_WHEN=midnight
 LOG_ROTATE_AT_UTC=True
+LOG_ROTATE_FILE_SUFIX="%Y%m%d"
 ```
 
 
-
-
 # Memory Management
 
 The library includes comprehensive memory management features to prevent memory leaks and optimize resource usage:
@@ -504,6 +480,45 @@ clear_logger_registry()
 ```
 
 
+# Flexible Configuration Options
+You can use either enums (for type safety) or strings (for simplicity):
+
+```python
+from pythonLogs import LogLevel, RotateWhen, LoggerType
+
+# Option 1: Type-safe enums (recommended)
+LogLevel.DEBUG     # "DEBUG"
+LogLevel.INFO      # "INFO"  
+LogLevel.WARNING   # "WARNING"
+LogLevel.ERROR     # "ERROR"
+LogLevel.CRITICAL  # "CRITICAL"
+
+# Option 2: String values (case-insensitive)
+"debug"       # Same as LogLevel.DEBUG
+"info"        # Same as LogLevel.INFO
+"warning"     # Same as LogLevel.WARNING  
+"warn"        # Same as LogLevel.WARN (alias)
+"error"       # Same as LogLevel.ERROR
+"critical"    # Same as LogLevel.CRITICAL
+"crit"        # Same as LogLevel.CRIT (alias)
+# Also supports: "DEBUG", "Info", "Warning", etc.
+
+# RotateWhen values
+RotateWhen.MIDNIGHT   # "midnight"
+RotateWhen.HOURLY     # "H"
+RotateWhen.DAILY      # "D"
+RotateWhen.MONDAY     # "W0"
+# ... through SUNDAY  # "W6"
+# String equivalents: "midnight", "H", "D", "W0"-"W6"
+
+# LoggerType values
+LoggerType.BASIC            # "basic"
+LoggerType.SIZE_ROTATING    # "size_rotating"  
+LoggerType.TIMED_ROTATING   # "timed_rotating"
+# String equivalents: "basic", "size_rotating", "timed_rotating"
+```
+
+
 # Migration Guide
 
 ## Upgrading from Legacy to Factory Pattern

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

@@ -2,11 +2,10 @@
 requires = ["poetry-core>=2.0.0,<3.0.0"]
 build-backend = "poetry.core.masonry.api"
 
-
 [tool.poetry]
 name = "pythonLogs"
-version = "4.0.1"
-description = "A modern, high-performance Python logging library with automatic file rotation, factory pattern for easy logger creation, and optimized caching for better performance."
+version = "4.0.3"
+description = "High-performance Python logging library with file rotation and optimized caching for better performance"
 license = "MIT"
 readme = "README.md"
 authors = ["Daniel Costa <danieldcsta@gmail.com>"]
@@ -31,38 +30,43 @@ classifiers = [
     "Natural Language :: English",
 ]
 
-
 [tool.poetry.dependencies]
 python = "^3.10"
+pydantic = "^2.11.7"
 pydantic-settings = "^2.10.1"
 python-dotenv = "^1.1.1"
 
-
 [tool.poetry.group.test.dependencies]
 coverage = "^7.9.2"
 poethepoet = "^0.36.0"
 psutil = "^7.0.0"
 pytest = "^8.4.1"
 
+[tool.poe.tasks]
+_test = "coverage run -m pytest -v"
+_coverage_report = "coverage report"
+_coverage_xml = "coverage xml"
+tests = ["_test", "_coverage_report", "_coverage_xml"]
+test = ["tests"]
 
 [tool.poetry.group.test]
 optional = true
 
+[tool.black]
+line-length = 120
+skip-string-normalization = true
+
 [tool.pytest.ini_options]
 markers = [
     "slow: marks tests as slow (deselect with '-m \"not slow\"')"
 ]
 
-
 [tool.coverage.run]
 omit = [
     "tests/*",
 ]
 
-
-[tool.poe.tasks]
-_test = "coverage run -m pytest -v"
-_coverage_report = "coverage report"
-_coverage_xml = "coverage xml"
-tests = ["_test", "_coverage_report", "_coverage_xml"]
-test = ["tests"]
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+]

{pythonlogs-4.0.1 → pythonlogs-4.0.3}/pythonLogs/.env.example

@@ -5,9 +5,11 @@ LOG_APPNAME=app
 LOG_FILENAME=app.log
 LOG_DIRECTORY=/app/logs
 LOG_DAYS_TO_KEEP=30
+LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
 LOG_STREAM_HANDLER=True
 LOG_SHOW_LOCATION=False
-LOG_DATE_FORMAT=%Y-%m-%dT%H:%M:%S
+LOG_MAX_LOGGERS=50
+LOG_LOGGER_TTL_SECONDS=1800
 
 # SizeRotatingLog
 LOG_MAX_FILE_SIZE_MB=10
@@ -15,3 +17,4 @@ LOG_MAX_FILE_SIZE_MB=10
 # TimedRotatingLog
 LOG_ROTATE_WHEN=midnight
 LOG_ROTATE_AT_UTC=True
+LOG_ROTATE_FILE_SUFIX="%Y%m%d"

{pythonlogs-4.0.1 → pythonlogs-4.0.3}/pythonLogs/factory.py

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8 -*-
+import atexit
 import logging
 import threading
 import time
@@ -28,6 +29,23 @@ class LoggerFactory:
     # Memory optimization settings
     _max_loggers = 100  # Maximum number of cached loggers
     _logger_ttl = 3600  # Logger TTL in seconds (1 hour)
+    _initialized = False  # Flag to track if memory limits have been initialized
+    _atexit_registered = False  # Flag to track if atexit cleanup is registered
+
+    @classmethod
+    def _ensure_initialized(cls) -> None:
+        """Ensure memory limits are initialized from settings on first use."""
+        if not cls._initialized:
+            from pythonLogs.settings import get_log_settings
+            settings = get_log_settings()
+            cls._max_loggers = settings.max_loggers
+            cls._logger_ttl = settings.logger_ttl_seconds
+            cls._initialized = True
+            
+        # Register atexit cleanup on first use
+        if not cls._atexit_registered:
+            atexit.register(cls._atexit_cleanup)
+            cls._atexit_registered = True
 
     @classmethod
     def get_or_create_logger(
@@ -54,6 +72,9 @@ class LoggerFactory:
 
         # Thread-safe check-and-create operation
         with cls._registry_lock:
+            # Initialize memory limits from settings on first use
+            cls._ensure_initialized()
+            
             # Clean up expired loggers first
             cls._cleanup_expired_loggers()
 
@@ -114,7 +135,7 @@ class LoggerFactory:
 
     @classmethod
     def set_memory_limits(cls, max_loggers: int = 100, ttl_seconds: int = 3600) -> None:
-        """Configure memory management limits for the logger registry.
+        """Configure memory management limits for the logger registry at runtime.
         
         Args:
             max_loggers: Maximum number of cached loggers
@@ -123,10 +144,20 @@ class LoggerFactory:
         with cls._registry_lock:
             cls._max_loggers = max_loggers
             cls._logger_ttl = ttl_seconds
+            cls._initialized = True  # Mark as manually configured
             # Clean up immediately with new settings
             cls._cleanup_expired_loggers()
             cls._enforce_size_limit()
 
+    @classmethod
+    def _atexit_cleanup(cls) -> None:
+        """Cleanup function registered with atexit to ensure proper resource cleanup."""
+        try:
+            cls.clear_registry()
+        except Exception:
+            # Silently ignore exceptions during shutdown cleanup
+            pass
+    
     @staticmethod
     def _cleanup_logger(logger: logging.Logger) -> None:
         """Clean up logger resources by closing all handlers."""

{pythonlogs-4.0.1 → pythonlogs-4.0.3}/pythonLogs/settings.py

@@ -23,15 +23,18 @@ class LogSettings(BaseSettings):
     """If any ENV variable is omitted, it falls back to default values here"""
 
     level: Optional[LogLevel] = Field(default=LogLevel.INFO)
+    timezone: Optional[str] = Field(default=DEFAULT_TIMEZONE)
+    encoding: Optional[str] = Field(default=DEFAULT_ENCODING)
     appname: Optional[str] = Field(default="app")
-    directory: Optional[str] = Field(default="/app/logs")
     filename: Optional[str] = Field(default="app.log")
-    encoding: Optional[str] = Field(default=DEFAULT_ENCODING)
-    date_format: Optional[str] = Field(default=DEFAULT_DATE_FORMAT)
+    directory: Optional[str] = Field(default="/app/logs")
     days_to_keep: Optional[int] = Field(default=DEFAULT_BACKUP_COUNT)
-    timezone: Optional[str] = Field(default=DEFAULT_TIMEZONE)
+    date_format: Optional[str] = Field(default=DEFAULT_DATE_FORMAT)
     stream_handler: Optional[bool] = Field(default=True)
     show_location: Optional[bool] = Field(default=False)
+    # Memory management
+    max_loggers: Optional[int] = Field(default=100)
+    logger_ttl_seconds: Optional[int] = Field(default=3600)
 
     # SizeRotatingLog
     max_file_size_mb: Optional[int] = Field(default=10)