V6.0.2

.github/PULL_REQUEST_TEMPLATE

@@ -3,14 +3,14 @@
 <!-- What is this pull request for? Does it fix any issues? -->
 
 ## Checklist
-- [ ] If code changes were made, then they have been tested.
-    - [ ] I have updated the documentation to reflect the changes.
-- [ ] I have thought about how this code may affect other services.
-- [ ] This PR fixes an issue.
-- [ ] This PR add/remove/change unit tests.
-- [ ] This PR adds something new (e.g. new method or parameters).
-- [ ] This PR is a breaking change (e.g. methods or parameters removed/renamed)
-- [ ] This PR is **not** a code change (e.g. documentation, README, ...)
+- [ ] If code changes were made, then they have been tested
+- [ ] I have updated the documentation to reflect any changes made
+- [ ] I have thought about how this code may affect other services
+- [ ] This PR fixes an issue
+- [ ] This PR is a breaking change (e.g. method, parameters, env variables)
+- [ ] This PR adds something new (e.g. method, parameters, env variables)
+- [ ] This PR change unit and integration tests
+- [ ] This PR is **NOT** a code change (e.g. documentation, packages)
 
 ## Reviewer
-- [ ] I understand that approving this code, I am also responsible for it going into the codebase.
+- [ ] I understand that approving this code, I am also responsible for it going into the codebase

.github/workflows/workflow.yml

@@ -5,19 +5,28 @@ name: CI/CD Pipeline
     branches: ['**']
     tags: ['v*']
 
+env:
+  LATEST_PYTHON_VERSION: '3.14'
 
 jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: "check"
+
   test:
     name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
-    runs-on: ${{ matrix.runs-on || matrix.os }}
+    runs-on: ${{ matrix.os }}
+    needs: lint
     strategy:
       fail-fast: false
       matrix:
-        os: ['ubuntu-latest', 'macos-latest', 'macos-14-arm64', 'windows-latest']
-        python-version: ['3.12', '3.13', '3.14']
-        include:
-          - os: 'macos-14-arm64'
-            runs-on: 'macos-14'
+        os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
+        python-version: ['3.11', '3.14']
     defaults:
       run:
         working-directory: ${{ github.workspace }}
@@ -31,41 +40,40 @@ jobs:
         run: uv python install ${{ matrix.python-version }}
 
       - name: Install dependencies
-        run: uv sync --all-extras
+        run: uv sync --all-extras --group dev
         shell: bash
 
       - name: Run tests with coverage
         uses: nick-fields/retry@v3
         with:
           timeout_minutes: 2
           max_attempts: 3
-          command: uv run pytest
+          command: uv run --no-sync pytest
           shell: bash
 
       - name: Upload coverage to Codecov
-        if: matrix.python-version == '3.14' && matrix.os == 'ubuntu-latest'
+        if: matrix.python-version == env.LATEST_PYTHON_VERSION && matrix.os == 'ubuntu-latest'
         uses: codecov/codecov-action@v5
 
       - name: Upload test results to Codecov
-        if: matrix.python-version == '3.14' && matrix.os == 'ubuntu-latest'
+        if: matrix.python-version == env.LATEST_PYTHON_VERSION && matrix.os == 'ubuntu-latest'
         uses: codecov/codecov-action@v5
         with:
           report_type: test_results
 
-
   build:
-    name: Build package
+    name: Build Package
     runs-on: ubuntu-latest
-    needs: [test]
+    needs: test
     if: startsWith(github.ref, 'refs/tags/v')
     steps:
       - uses: actions/checkout@v6
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7
 
-      - name: Set up Python 3.14
-        run: uv python install 3.14
+      - name: Set up Python ${{ env.LATEST_PYTHON_VERSION }}
+        run: uv python install ${{ env.LATEST_PYTHON_VERSION }}
 
       - name: Build package
         run: uv build
@@ -77,11 +85,10 @@ jobs:
           path: dist/
           retention-days: 7
 
-
   release:
     name: Create Release
     runs-on: ubuntu-latest
-    needs: [build]
+    needs: build
     if: startsWith(github.ref, 'refs/tags/v')
     permissions:
       contents: write

pyproject.toml

@@ -2,16 +2,31 @@
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build]
+include = ["pythonLogs/**/*"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["pythonLogs"]
+
 [project]
 name = "pythonLogs"
-version = "6.0.1"
+version = "6.0.2"
 description = "High-performance Python logging library with file rotation and optimized caching for better performance"
+urls.Repository = "https://github.com/ddc/pythonLogs"
+urls.Homepage = "https://pypi.org/project/pythonLogs"
 license = {text = "MIT"}
 readme = "README.md"
-authors = [{name = "Daniel Costa", email = "danieldcsta@gmail.com"}]
-maintainers = [{name = "Daniel Costa"}]
+authors = [
+    {name = "Daniel Costa", email = "danieldcsta@gmail.com"},
+]
+maintainers = [
+    {name = "Daniel Costa"},
+]
 keywords = [
-    "python3", "python-3", "python",
+    "python", "python3", "python-3",
     "log", "logging", "logger",
     "logutils", "log-utils", "pythonLogs"
 ]
@@ -20,6 +35,7 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
@@ -28,52 +44,46 @@ classifiers = [
     "Intended Audience :: Developers",
     "Natural Language :: English",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 dependencies = [
     "pydantic-settings>=2.11.0",
 ]
 
-[project.urls]
-Homepage = "https://pypi.org/project/pythonLogs"
-Repository = "https://github.com/ddc/pythonLogs"
-
-[project.optional-dependencies]
-test = [
-    "poethepoet>=0.40.0",
+[dependency-groups]
+dev = [
     "psutil>=7.2.2",
     "pytest>=9.0.2",
     "pytest-cov>=7.0.0",
+    "coverage>=7.13.3",
+    "black>=26.1.0",
+    "poethepoet>=0.40.0",
+    "ruff>=0.15.0",
 ]
 
-[tool.hatch.build]
-include = ["pythonLogs/**/*"]
-
-[tool.hatch.build.targets.wheel]
-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 . && uv run black ."
-profile = "uv run python -m cProfile -o cprofile.prof -m pytest"
+profile = "uv run python -m cProfile -o cprofile_unit.prof -m pytest --no-cov"
 test = "uv run pytest"
+updatedev.sequence = ["linter", {shell = "uv lock && uv sync --all-extras --group dev"}]
+build.sequence = ["updatedev", {shell = "uv build --wheel"}]
 
 [tool.pytest.ini_options]
 addopts = "-v --cov --cov-report=term --cov-report=xml --junitxml=junit.xml"
 junit_family = "legacy"
 testpaths = ["tests"]
 markers = [
-    "slow: marks tests as slow (deselect with '-m \"not slow\"')"
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
 ]
 
 [tool.coverage.run]
 omit = [
     "tests/*",
     "*/__init__.py",
-    "*/_version.py",
 ]
 
 [tool.coverage.report]
+show_missing = true
+skip_covered = false
 exclude_lines = [
     "pragma: no cover",
     "def __repr__",
@@ -86,31 +96,25 @@ exclude_lines = [
     "class .*\\bProtocol\\):",
     "@(abc\\.)?abstractmethod",
 ]
-show_missing = true
-skip_covered = false
 
 [tool.black]
 line-length = 120
 skip-string-normalization = true
 
 [tool.ruff]
 line-length = 120
+target-version = "py311"
 
 [tool.ruff.lint]
-# I - Import sorting and organization
-# F401 - Detect and remove unused imports
-select = ["I", "F401"]
+select = ["E", "W", "F", "I", "B", "C4", "UP"]
+ignore = ["E501", "E402", "UP046", "UP047"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]
+"tests/**/*.py" = ["S101", "S105", "S106", "S311", "SLF001", "F841"]
 
 [tool.ruff.lint.isort]
 known-first-party = ["pythonLogs"]
 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/.env.example

@@ -15,6 +15,7 @@ LOG_STREAM_HANDLER=True
 LOG_SHOW_LOCATION=False
 # Memory Management Settings
 LOG_MAX_LOGGERS=50
+LOG_MAX_FORMATTERS=50
 LOG_LOGGER_TTL_SECONDS=1800
 
 # SizeRotatingLog Settings (only needed when using SizeRotatingLog)

pythonLogs/basic_log.py

@@ -5,7 +5,7 @@
 from pythonLogs.core.thread_safety import auto_thread_safe
 
 
-@auto_thread_safe(['init'])
+@auto_thread_safe(["init"])
 class BasicLog:
     """Basic logger with context manager support for automatic resource cleanup."""
 
@@ -48,13 +48,13 @@ def init(self):
 
     def __enter__(self):
         """Context manager entry."""
-        if not hasattr(self, 'logger') or self.logger is None:
+        if not hasattr(self, "logger") or self.logger is None:
             self.init()
         return self.logger
 
     def __exit__(self, exc_type, exc_val, exc_tb):
         """Context manager exit with automatic cleanup."""
-        if hasattr(self, 'logger'):
+        if hasattr(self, "logger"):
             cleanup_logger_handlers(self.logger)
 
     @staticmethod

pythonLogs/core/constants.py

@@ -1,5 +1,5 @@
 import logging
-from enum import Enum
+from enum import StrEnum
 
 # File and Directory Constants
 MB_TO_BYTES = 1024 * 1024
@@ -17,7 +17,7 @@
 DEFAULT_TIMEZONE = "UTC"
 
 
-class LogLevel(str, Enum):
+class LogLevel(StrEnum):
     """Log levels"""
 
     CRITICAL = "CRITICAL"
@@ -29,7 +29,7 @@ class LogLevel(str, Enum):
     DEBUG = "DEBUG"
 
 
-class RotateWhen(str, Enum):
+class RotateWhen(StrEnum):
     """Rotation timing options for TimedRotatingLog"""
 
     MIDNIGHT = "midnight"