VersaLog 2.5.4__tar.gz → 2.6.0__tar.gz

{versalog-2.5.4 → versalog-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: VersaLog
-Version: 2.5.4
+Version: 2.6.0
 Summary: Versatile logging library.
 Home-page: 
 Author: 
@@ -17,6 +17,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8, <3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: plyer
 
 ## What is VersaLog.py?
 
@@ -27,8 +28,69 @@ License-File: LICENSE
 [![Discord](https://img.shields.io/badge/Discord-Support%20Server-7289DA?style=flat&logo=discord)](https://discord.gg/Ms2ejEES)
 
 What is VersaLog.py?
-VersaLog is a powerful and flexible logging library for Python.
-It supports everything from simple usage to advanced, highly customizable configurations to meet a wide range of needs.
+
+VersaLog is a modern, powerful, and flexible logging library for Python.
+It supports everything from simple usage to advanced, highly customizable configurations, making it suitable for a wide range of use cases.
+
+## Feature
+
+### Basic Logging
+
+- Supports standard log levels:
+   - `INFO`, `ERROR`, `WARNING`, `DEBUG`, `CRITICAL`
+- Colored output for better readability
+- Symbol-based prefixes (e.g. `[+]`, `[-]`, `[!]`)
+
+### Multiple Output Formats
+
+**Easily switch between different log styles:**
+
+- `simple` → `[+] message`
+- `simple2` → `[TIME] [+] message`
+- `detailed` → `[TIME][LEVEL] : message`
+- `file` → `[FILE:LINE][LEVEL] message`
+
+### Tag System
+
+- Add custom tags to logs
+- Supports multiple tags (e.g. `["API", "AUTH"]`)
+- Optional default tags
+
+### File & Line Tracking
+
+- Display caller file name and line number
+- Useful for debugging large projects
+
+### Log File Saving
+
+- Automatically save logs to files
+- Output path: `./log/YYYY-MM-DD.log`
+- Select which log levels to save
+
+### Auto Cleanup
+
+- Automatically deletes old log files (default: 7 days)
+- Keeps your log directory clean
+
+### Auto Cleanup
+
+- Disable console output
+- Useful for background services
+
+### Exception Handling
+
+- Automatically captures unhandled exceptions
+- Logs them as `CRITICAL`
+
+### Desktop Notifications
+
+- Optional desktop alerts for errors and critical logs
+- Uses `plyer.notification`
+
+### Asynchronous Logging
+
+- Non-blocking log processing using threads and queues
+- Improves performance in high-load environments
 
 ## Support
 
@@ -74,12 +136,4 @@ logger = VersaLog(enum="detailed", tag="a", show_tag=True)
 
 # two tag
 logger = VersaLog(enum="detailed", tag=["a", "a"], show_tag=True)
-```                                                                                                    |
-
-## Log save
-
-````
-
-[2025-08-06 04:10:36][INFO] : ok
-
 ```

{versalog-2.5.4 → versalog-2.6.0}/README.md

@@ -7,8 +7,69 @@
 [![Discord](https://img.shields.io/badge/Discord-Support%20Server-7289DA?style=flat&logo=discord)](https://discord.gg/Ms2ejEES)
 
 What is VersaLog.py?
-VersaLog is a powerful and flexible logging library for Python.
-It supports everything from simple usage to advanced, highly customizable configurations to meet a wide range of needs.
+
+VersaLog is a modern, powerful, and flexible logging library for Python.
+It supports everything from simple usage to advanced, highly customizable configurations, making it suitable for a wide range of use cases.
+
+## Feature
+
+### Basic Logging
+
+- Supports standard log levels:
+   - `INFO`, `ERROR`, `WARNING`, `DEBUG`, `CRITICAL`
+- Colored output for better readability
+- Symbol-based prefixes (e.g. `[+]`, `[-]`, `[!]`)
+
+### Multiple Output Formats
+
+**Easily switch between different log styles:**
+
+- `simple` → `[+] message`
+- `simple2` → `[TIME] [+] message`
+- `detailed` → `[TIME][LEVEL] : message`
+- `file` → `[FILE:LINE][LEVEL] message`
+
+### Tag System
+
+- Add custom tags to logs
+- Supports multiple tags (e.g. `["API", "AUTH"]`)
+- Optional default tags
+
+### File & Line Tracking
+
+- Display caller file name and line number
+- Useful for debugging large projects
+
+### Log File Saving
+
+- Automatically save logs to files
+- Output path: `./log/YYYY-MM-DD.log`
+- Select which log levels to save
+
+### Auto Cleanup
+
+- Automatically deletes old log files (default: 7 days)
+- Keeps your log directory clean
+
+### Auto Cleanup
+
+- Disable console output
+- Useful for background services
+
+### Exception Handling
+
+- Automatically captures unhandled exceptions
+- Logs them as `CRITICAL`
+
+### Desktop Notifications
+
+- Optional desktop alerts for errors and critical logs
+- Uses `plyer.notification`
+
+### Asynchronous Logging
+
+- Non-blocking log processing using threads and queues
+- Improves performance in high-load environments
 
 ## Support
 
@@ -54,12 +115,4 @@ logger = VersaLog(enum="detailed", tag="a", show_tag=True)
 
 # two tag
 logger = VersaLog(enum="detailed", tag=["a", "a"], show_tag=True)
-```                                                                                                    |
-
-## Log save
-
-````
-
-[2025-08-06 04:10:36][INFO] : ok
-
 ```

versalog-2.6.0/VersaLog/__init__.py

@@ -0,0 +1,13 @@
+from .core import VersaLog
+from .handler import VersaLogHandler
+from .integrations.auto import auto_setup
+from .integrations.fastapi import setup_fastapi_logging
+from .integrations.flask import setup_flask_logging
+from .integrations.django import setup_django_logging
+
+__copyright__ = "Copyright 2025 by Kayu0514"
+__version__ = "2.6.0"
+__author__ = "Kayu0514"
+__url__ = "https://github.com/kayu0514"
+
+__all__ = ["VersaLog", "VersaLogHandler", "auto_setup", "setup_fastapi_logging","setup_flask_logging", "setup_django_logging"]

{versalog-2.5.4 → versalog-2.6.0}/VersaLog/core.py

@@ -87,7 +87,7 @@ class VersaLog:
             if self.save_levels is None:
                 self.save_levels = self.valid_save_levels.copy()
             elif not isinstance(self.save_levels, list):
-                raise ValueError(f"save_levels must be a list. Example: ['ERROR']")
+                raise ValueError("save_levels must be a list. Example: ['ERROR']")
             elif not all(level in self.valid_save_levels for level in self.save_levels):
                 raise ValueError(f"Invalid save_levels specified. Valid levels are: {', '.join(self.valid_save_levels)}")
             
@@ -179,42 +179,39 @@ class VersaLog:
             tags = [final_tag] if final_tag else []
         else:
             tags = []
-        tag_str = "".join(f"[{t}]" for t in tags) if tags else ""
+        tag_str = "".join(f"[{t}]" for t in tags)
 
         caller = self._GetCaller() if self.show_file or self.enum == "file" else ""
 
         if self.enum == "simple":
             symbol = self.SYMBOLS.get(tye, "[?]")
             if self.show_file:
-                formatted = f"[{caller}]{tag_str}{colors}{symbol}{self.RESET} {msg}" if tag_str else f"[{caller}]{colors}{symbol}{self.RESET} {msg}"
-                plain = f"[{caller}]{tag_str}{symbol} {msg}" if tag_str else f"[{caller}]{symbol} {msg}"
+                # tag_str is empty string if no tags, otherwise formatted as "[tag1][tag2]..."
+                formatted = f"[{caller}]{tag_str}{colors}{symbol}{self.RESET} {msg}"
+                plain = f"[{caller}]{tag_str}{symbol} {msg}"
             else:
-                formatted = f"{tag_str}{colors}{symbol}{self.RESET} {msg}" if tag_str else f"{colors}{symbol}{self.RESET} {msg}"
-                plain = f"{tag_str}{symbol} {msg}" if tag_str else f"{symbol} {msg}"
+                formatted = f"{tag_str}{colors}{symbol}{self.RESET} {msg}"
+                plain = f"{tag_str}{symbol} {msg}"
 
         elif self.enum == "simple2":
             symbol = self.SYMBOLS.get(tye, "[?]")
             time = self._GetTime()
             if self.show_file:
-                formatted = f"[{time}] [{caller}]{tag_str}{colors}{symbol}{self.RESET} {msg}" if tag_str else f"[{time}] [{caller}]{colors}{symbol}{self.RESET} {msg}"
-                plain = f"[{time}] [{caller}]{tag_str}{symbol} {msg}" if tag_str else f"[{time}] [{caller}]{symbol} {msg}"
+                formatted = f"[{time}] [{caller}]{tag_str}{colors}{symbol}{self.RESET} {msg}"
+                plain = f"[{time}] [{caller}]{tag_str}{symbol} {msg}"
             else:
-                formatted = f"[{time}] {tag_str}{colors}{symbol}{self.RESET} {msg}" if tag_str else f"[{time}] {colors}{symbol}{self.RESET} {msg}"
-                plain = f"[{time}] {tag_str}{symbol} {msg}" if tag_str else f"[{time}] {symbol} {msg}"
+                formatted = f"[{time}] {tag_str}{colors}{symbol}{self.RESET} {msg}"
+                plain = f"[{time}] {tag_str}{symbol} {msg}"
 
         elif self.enum == "file":
-            formatted = f"[{caller}]{tag_str}{colors}[{types}]{self.RESET} {msg}" if tag_str else f"[{caller}]{colors}[{types}]{self.RESET} {msg}"
-            plain = f"[{caller}]{tag_str}[{types}] {msg}" if tag_str else f"[{caller}][{types}] {msg}"
+            formatted = f"[{caller}]{tag_str}{colors}[{types}]{self.RESET} {msg}"
+            plain = f"[{caller}]{tag_str}[{types}] {msg}"
 
         else:  # detailed
             time = self._GetTime()
-            formatted = f"[{time}]{colors}[{types}]{self.RESET}{tag_str}" if tag_str else f"[{time}]{colors}[{types}]{self.RESET}"
-            plain = f"[{time}][{types}]{tag_str}" if tag_str else f"[{time}][{types}]"
-            if self.show_file:
-                formatted += f"[{caller}]"
-                plain += f"[{caller}]"
-            formatted += f" : {msg}"
-            plain += f" : {msg}"
+            caller_part = f"[{caller}]" if self.show_file else ""
+            formatted = f"[{time}]{colors}[{types}]{self.RESET}{tag_str}{caller_part} : {msg}"
+            plain = f"[{time}][{types}]{tag_str}{caller_part} : {msg}"
 
         if not self.silent:
             print(formatted)

versalog-2.6.0/VersaLog/integrations/auto.py

@@ -0,0 +1,32 @@
+import sys
+
+from .generic import setup_logging
+from .fastapi import setup_fastapi_logging
+from .flask import setup_flask_logging
+from .django import setup_django_logging
+
+
+def auto_setup(versalog):
+    """
+    Automatically detects the runtime environment
+    and applies the appropriate logging configuration.
+    """
+
+    if "uvicorn" in sys.modules:
+        setup_fastapi_logging(versalog)
+        return "fastapi"
+
+    if "gunicorn" in sys.modules:
+        setup_fastapi_logging(versalog)
+        return "gunicorn"
+
+    if "flask" in sys.modules:
+        setup_flask_logging(None, versalog)
+        return "flask"
+
+    if "django" in sys.modules:
+        setup_django_logging(versalog)
+        return "django"
+
+    setup_logging(versalog)
+    return "generic"

versalog-2.6.0/VersaLog/integrations/django.py

@@ -0,0 +1,5 @@
+from .generic import setup_logging
+
+
+def setup_django_logging(versalog):
+    setup_logging(versalog)

versalog-2.6.0/VersaLog/integrations/flask.py

@@ -0,0 +1,8 @@
+from .generic import setup_logging
+
+
+def setup_flask_logging(app, versalog):
+    setup_logging(versalog)
+
+    app.logger.handlers.clear()
+    app.logger.propagate = True

versalog-2.6.0/VersaLog/integrations/generic.py

@@ -0,0 +1,14 @@
+import logging
+from ..handler import VersaLogHandler
+
+
+def setup_logging(versalog):
+    handler = VersaLogHandler(versalog)
+
+    root = logging.getLogger()
+
+    for h in root.handlers[:]:
+        root.removeHandler(h)
+
+    root.setLevel(logging.NOTSET)
+    root.addHandler(handler)

{versalog-2.5.4 → versalog-2.6.0}/VersaLog.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: VersaLog
-Version: 2.5.4
+Version: 2.6.0
 Summary: Versatile logging library.
 Home-page: 
 Author: 
@@ -17,6 +17,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8, <3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: plyer
 
 ## What is VersaLog.py?
 
@@ -27,8 +28,69 @@ License-File: LICENSE
 [![Discord](https://img.shields.io/badge/Discord-Support%20Server-7289DA?style=flat&logo=discord)](https://discord.gg/Ms2ejEES)
 
 What is VersaLog.py?
-VersaLog is a powerful and flexible logging library for Python.
-It supports everything from simple usage to advanced, highly customizable configurations to meet a wide range of needs.
+
+VersaLog is a modern, powerful, and flexible logging library for Python.
+It supports everything from simple usage to advanced, highly customizable configurations, making it suitable for a wide range of use cases.
+
+## Feature
+
+### Basic Logging
+
+- Supports standard log levels:
+   - `INFO`, `ERROR`, `WARNING`, `DEBUG`, `CRITICAL`
+- Colored output for better readability
+- Symbol-based prefixes (e.g. `[+]`, `[-]`, `[!]`)
+
+### Multiple Output Formats
+
+**Easily switch between different log styles:**
+
+- `simple` → `[+] message`
+- `simple2` → `[TIME] [+] message`
+- `detailed` → `[TIME][LEVEL] : message`
+- `file` → `[FILE:LINE][LEVEL] message`
+
+### Tag System
+
+- Add custom tags to logs
+- Supports multiple tags (e.g. `["API", "AUTH"]`)
+- Optional default tags
+
+### File & Line Tracking
+
+- Display caller file name and line number
+- Useful for debugging large projects
+
+### Log File Saving
+
+- Automatically save logs to files
+- Output path: `./log/YYYY-MM-DD.log`
+- Select which log levels to save
+
+### Auto Cleanup
+
+- Automatically deletes old log files (default: 7 days)
+- Keeps your log directory clean
+
+### Auto Cleanup
+
+- Disable console output
+- Useful for background services
+
+### Exception Handling
+
+- Automatically captures unhandled exceptions
+- Logs them as `CRITICAL`
+
+### Desktop Notifications
+
+- Optional desktop alerts for errors and critical logs
+- Uses `plyer.notification`
+
+### Asynchronous Logging
+
+- Non-blocking log processing using threads and queues
+- Improves performance in high-load environments
 
 ## Support
 
@@ -74,12 +136,4 @@ logger = VersaLog(enum="detailed", tag="a", show_tag=True)
 
 # two tag
 logger = VersaLog(enum="detailed", tag=["a", "a"], show_tag=True)
-```                                                                                                    |
-
-## Log save
-
-````
-
-[2025-08-06 04:10:36][INFO] : ok
-
 ```

{versalog-2.5.4 → versalog-2.6.0}/VersaLog.egg-info/SOURCES.txt

@@ -7,6 +7,11 @@ VersaLog/handler.py
 VersaLog.egg-info/PKG-INFO
 VersaLog.egg-info/SOURCES.txt
 VersaLog.egg-info/dependency_links.txt
+VersaLog.egg-info/requires.txt
 VersaLog.egg-info/top_level.txt
 VersaLog/integrations/__init__.py
-VersaLog/integrations/fastapi.py
+VersaLog/integrations/auto.py
+VersaLog/integrations/django.py
+VersaLog/integrations/fastapi.py
+VersaLog/integrations/flask.py
+VersaLog/integrations/generic.py

versalog-2.6.0/VersaLog.egg-info/requires.txt

@@ -0,0 +1 @@
+plyer

{versalog-2.5.4 → versalog-2.6.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="VersaLog",
-    version="2.5.4",
+    version="2.6.0",
     description="Versatile logging library.",
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -13,7 +13,9 @@ setup(
     license="MIT",
     packages=find_packages(include=["VersaLog", "VersaLog.*"]),
     include_package_data=True,
-    install_requires=[],
+    install_requires=[
+        "plyer"
+    ],
     python_requires=">=3.8, <3.14",
     url="",
     classifiers=[

versalog-2.5.4/VersaLog/__init__.py

@@ -1,10 +0,0 @@
-from .core import VersaLog
-from .handler import VersaLogHandler
-from .integrations.fastapi import setup_fastapi_logging
-
-__copyright__ = "Copyright 2025 by Kayu0514"
-__version__ = "2.5.4"
-__author__ = "Kayu0514"
-__url__ = "https://github.com/kayu0514"
-
-__all__ = ["VersaLog", "VersaLogHandler", "setup_fastapi_logging"]