VersaLog 2.6.0__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: VersaLog
-Version: 2.6.0
+Version: 3.0.0
 Summary: Versatile logging library.
 Home-page: 
 Author: 
@@ -18,6 +18,14 @@ 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?
 

{versalog-2.6.0 → versalog-3.0.0}/VersaLog/__init__.py

@@ -4,10 +4,10 @@ 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__ = "2.6.0"
+__version__ = "3.0.0"
 __author__ = "Kayu0514"
 __url__ = "https://github.com/kayu0514"
-
-__all__ = ["VersaLog", "VersaLogHandler", "auto_setup", "setup_fastapi_logging","setup_flask_logging", "setup_django_logging"]
+__all__ = ["VersaLog", "VersaLogHandler", "WebhookHandler", "auto_setup", "setup_fastapi_logging","setup_flask_logging", "setup_django_logging"]

{versalog-2.6.0 → 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/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/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.6.0 → versalog-3.0.0}/VersaLog.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: VersaLog
-Version: 2.6.0
+Version: 3.0.0
 Summary: Versatile logging library.
 Home-page: 
 Author: 
@@ -18,6 +18,14 @@ 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?
 

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

@@ -14,4 +14,8 @@ VersaLog/integrations/auto.py
 VersaLog/integrations/django.py
 VersaLog/integrations/fastapi.py
 VersaLog/integrations/flask.py
-VersaLog/integrations/generic.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-2.6.0 → versalog-3.0.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="VersaLog",
-    version="2.6.0",
+    version="3.0.0",
     description="Versatile logging library.",
     long_description=long_description,
     long_description_content_type="text/markdown",

versalog-2.6.0/VersaLog/integrations/django.py

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