pythonLogs 4.0.1__tar.gz → 4.0.2__tar.gz

{pythonlogs-4.0.1 → pythonlogs-4.0.2}/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.2
+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
@@ -413,18 +414,28 @@ error_logger.error("Database connection failed")
 audit_logger.info("User admin logged in")
 ```
 
-## Env Variables (Optional)
+## Env Variables (Optional | Production)
+.env variables 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,6 +443,7 @@ 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.2}/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
@@ -384,18 +384,28 @@ error_logger.error("Database connection failed")
 audit_logger.info("User admin logged in")
 ```
 
-## Env Variables (Optional)
+## Env Variables (Optional | Production)
+.env variables 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,6 +413,7 @@ 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.2}/pyproject.toml

@@ -5,8 +5,8 @@ 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.2"
+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>"]
@@ -34,6 +34,7 @@ classifiers = [
 
 [tool.poetry.dependencies]
 python = "^3.10"
+pydantic = "^2.11.7"
 pydantic-settings = "^2.10.1"
 python-dotenv = "^1.1.1"
 
@@ -48,6 +49,12 @@ pytest = "^8.4.1"
 [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\"')"
@@ -60,6 +67,12 @@ omit = [
 ]
 
 
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+]
+
+
 [tool.poe.tasks]
 _test = "coverage run -m pytest -v"
 _coverage_report = "coverage report"

{pythonlogs-4.0.1 → pythonlogs-4.0.2}/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.2}/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.2}/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)