VersaLog 2.5.5__tar.gz → 3.0.0__tar.gz

{versalog-2.5.5/VersaLog.egg-info → versalog-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: VersaLog
-Version: 2.5.5
+Version: 3.0.0
 Summary: Versatile logging library.
 Home-page: 
 Author: 
@@ -17,6 +17,15 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8, <3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: plyer
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 ## What is VersaLog.py?
 
@@ -27,8 +36,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 +144,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/PKG-INFO → versalog-3.0.0/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.1
-Name: VersaLog
-Version: 2.5.5
-Summary: Versatile logging library.
-Home-page: 
-Author: 
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8, <3.14
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
 ## What is VersaLog.py?
 
 [![PyPI version](https://badge.fury.io/py/VersaLog.svg)](https://badge.fury.io/py/VersaLog)
@@ -27,8 +7,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 +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-3.0.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
+from .integrations.webhook import WebhookHandler
+
+__copyright__ = "Copyright 2025 by Kayu0514"
+__version__ = "3.0.0"
+__author__ = "Kayu0514"
+__url__ = "https://github.com/kayu0514"
+__all__ = ["VersaLog", "VersaLogHandler", "WebhookHandler", "auto_setup", "setup_fastapi_logging","setup_flask_logging", "setup_django_logging"]

{versalog-2.5.5 → versalog-3.0.0}/VersaLog/core.py

@@ -2,6 +2,8 @@ from typing import Optional, Union, List
 from plyer import notification
 from contextlib import contextmanager
 
+from .integrations.webhook import WebhookHandler
+
 import datetime
 import inspect
 import os
@@ -73,6 +75,7 @@ class VersaLog:
         self.all_save = all_save
         self.save_levels = save_levels
         self.silent = silent
+        self._webhook_handlers = []
 
         self.log_queue = queue.Queue()
         self.worker_thread = threading.Thread(target=self._worker, daemon=True)
@@ -218,6 +221,32 @@ class VersaLog:
 
         self._save_log(plain, types)
 
+    def add_webhook(self, url: str, level: str = "ERROR", *, format: str = "generic", timeout: float = 3.0, headers: Optional[dict] = None,):
+        """Register a webhook destination for logs at or above ``level``.
+    
+        ``format`` can be ``"generic"``, ``"discord"``, or ``"slack"``.
+        The default ``"ERROR"`` sends ERROR and CRITICAL logs.
+        """
+        
+        handler = WebhookHandler(url=url, level=level, format=format, timeout=timeout, headers=headers)
+        self._webhook_handlers.append(handler)
+        return handler
+    
+    def remove_webhook(self, handler) -> bool:
+        try:
+            self._webhook_handlers.remove(handler)
+            return True
+        except ValueError:
+            return False
+    
+    def _dispatch_webhooks(self, message: str, level: str) -> None:
+        for handler in tuple(self._webhook_handlers):
+            if handler.should_handle(level):
+                try:
+                    handler.emit(message, level)
+                except Exception:
+                    pass
+
     def info(self, msg: str, tag: Optional[Union[str, List[str]]] = None) -> None:
         self._Log(msg, "INFO", tag)
 

versalog-3.0.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-3.0.0/VersaLog/integrations/django.py

@@ -0,0 +1,19 @@
+import logging
+from ..handler import VersaLogHandle
+
+
+def setup_django_logging(versalog):
+    handler = VersaLogHandler(versalog)
+
+    root = logging.getLogger()
+    for h in root.handlers[:]:
+        root.removeHandler(h)
+    root.setLevel(logging.NOTSET)
+    root.addHandler(handler)
+
+    for name in ["django", "django.request", "django.server", "django.db.backends"]:
+        logger = logging.getLogger(name)
+        for h in logger.handlers[:]:
+            logger.removeHandler(h)
+        logger.propagate = True
+        logger.setLevel(logging.NOTSET)

versalog-3.0.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-3.0.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-3.0.0/VersaLog/integrations/webhook/__init__.py

@@ -0,0 +1,3 @@
+from .handler import WebhookHandler
+
+__all__ = ["WebhookHandler"]

versalog-3.0.0/VersaLog/integrations/webhook/formatters.py

@@ -0,0 +1,17 @@
+import datetime
+
+
+def format_payload(level, message, format="generic"):
+    timestamp = datetime.datetime.now(datetime.timezone.utc).isoformat()
+    if format == "generic":
+        return {
+            "source": "VersaLog",
+            "level": level,
+            "message": message,
+            "timestamp": timestamp,
+        }
+    if format == "discord":
+        return {"content": f"[{level}] {message}"}
+    if format == "slack":
+        return {"text": f"[{level}] {message}"}
+    raise ValueError("format must be 'generic', 'discord', or 'slack'")

versalog-3.0.0/VersaLog/integrations/webhook/handler.py

@@ -0,0 +1,43 @@
+from .formatters import format_payload
+from .sender import send_json
+
+
+LEVELS = {
+    "DEBUG": 10,
+    "INFO": 20,
+    "WARNING": 30,
+    "ERROR": 40,
+    "CRITICAL": 50,
+}
+
+
+class WebhookHandler:
+    def __init__(self, url, level="ERROR", format="generic", timeout=3.0, headers=None):
+        if not isinstance(url, str) or not url.strip():
+            raise ValueError("url must be a non-empty string")
+        normalized_level = str(level).upper()
+        if normalized_level not in LEVELS:
+            raise ValueError(
+                "level must be one of: " + ", ".join(LEVELS.keys())
+            )
+        if format not in ("generic", "discord", "slack"):
+            raise ValueError("format must be 'generic', 'discord', or 'slack'")
+        if timeout <= 0:
+            raise ValueError("timeout must be greater than 0")
+
+        self.url = url
+        self.level = normalized_level
+        self.format = format
+        self.timeout = timeout
+        self.headers = dict(headers or {})
+        self.last_success = None
+
+    def should_handle(self, level):
+        return LEVELS.get(str(level).upper(), 0) >= LEVELS[self.level]
+
+    def emit(self, message, level):
+        payload = format_payload(str(level).upper(), str(message), self.format)
+        self.last_success = send_json(
+            self.url, payload, timeout=self.timeout, headers=self.headers
+        )
+        return self.last_success

versalog-3.0.0/VersaLog/integrations/webhook/sender.py

@@ -0,0 +1,16 @@
+import json
+from urllib.error import HTTPError, URLError
+from urllib.request import Request, urlopen
+
+
+def send_json(url, payload, timeout=3.0, headers=None):
+    request_headers = {"Content-Type": "application/json; charset=utf-8"}
+    if headers:
+        request_headers.update(headers)
+    data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
+    request = Request(url, data=data, headers=request_headers, method="POST")
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            return 200 <= response.status < 300
+    except (HTTPError, URLError, TimeoutError, OSError, ValueError):
+        return False

versalog-2.5.5/README.md → versalog-3.0.0/VersaLog.egg-info/PKG-INFO

@@ -1,3 +1,32 @@
+Metadata-Version: 2.4
+Name: VersaLog
+Version: 3.0.0
+Summary: Versatile logging library.
+Home-page: 
+Author: 
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8, <3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: plyer
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
 ## What is VersaLog.py?
 
 [![PyPI version](https://badge.fury.io/py/VersaLog.svg)](https://badge.fury.io/py/VersaLog)
@@ -7,8 +36,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 +144,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-3.0.0/VersaLog.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+setup.py
+VersaLog/__init__.py
+VersaLog/core.py
+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/auto.py
+VersaLog/integrations/django.py
+VersaLog/integrations/fastapi.py
+VersaLog/integrations/flask.py
+VersaLog/integrations/generic.py
+VersaLog/integrations/webhook/__init__.py
+VersaLog/integrations/webhook/formatters.py
+VersaLog/integrations/webhook/handler.py
+VersaLog/integrations/webhook/sender.py

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

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

{versalog-2.5.5 → versalog-3.0.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="VersaLog",
-    version="2.5.5",
+    version="3.0.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"]

versalog-2.5.5/VersaLog.egg-info/SOURCES.txt

@@ -1,12 +0,0 @@
-LICENSE
-README.md
-setup.py
-VersaLog/__init__.py
-VersaLog/core.py
-VersaLog/handler.py
-VersaLog.egg-info/PKG-INFO
-VersaLog.egg-info/SOURCES.txt
-VersaLog.egg-info/dependency_links.txt
-VersaLog.egg-info/top_level.txt
-VersaLog/integrations/__init__.py
-VersaLog/integrations/fastapi.py