VersaLog 2.5.5__tar.gz → 2.6.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: VersaLog
-Version: 2.5.5
+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.5 → 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.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.5 → versalog-2.6.0}/VersaLog.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: VersaLog
-Version: 2.5.5
+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.5 → 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.5 → 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.5",
+    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.5/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.5"
-__author__ = "Kayu0514"
-__url__ = "https://github.com/kayu0514"
-
-__all__ = ["VersaLog", "VersaLogHandler", "setup_fastapi_logging"]