Merge pull request #1579 from priya05-git/feature/unified-error-reporting-telemetry-dashboard

Add: undefied error reporting

Author: steam-bell-92

README.md

@@ -9,6 +9,10 @@
 [![Python Version](https://img.shields.io/badge/python-3.10--3.12-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
+### 🧪 New: Standardized Error Logging
+A shared error logger is now available for mini-projects. It captures exception type, message, timestamp, traceback, and project name into JSONL logs under the logs folder, making failures easier to review and analyze.
+
+[Quick Start](#-quick-start) • [Projects](#-projects) • [Features](#-features) • [Contributing](#-contributing)
 <p align="center">
   <a href="https://python-mini-project-lovat.vercel.app/">
     <img src="https://img.shields.io/badge/live_demo-View%20App-22c55e?style=for-the-badge&logo=vercel&logoColor=white" alt="Live Demo" />

error_logger.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+import json
+import traceback
+from collections import Counter
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+
+DEFAULT_LOG_PATH = Path(__file__).resolve().parent / "logs" / "error-logs.jsonl"
+
+
+def _ensure_log_path(log_path: str | Path | None) -> Path:
+    path = Path(log_path) if log_path is not None else DEFAULT_LOG_PATH
+    path.parent.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def log_exception(
+    project_name: str,
+    exception: Exception,
+    log_path: str | Path | None = None,
+    additional_data: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    """Write a structured exception entry to a JSON Lines log file."""
+    path = _ensure_log_path(log_path)
+    payload = {
+        "project_name": project_name,
+        "exception_type": type(exception).__name__,
+        "error_message": str(exception),
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "traceback": "".join(traceback.format_exception(type(exception), exception, exception.__traceback__)),
+    }
+
+    if additional_data:
+        payload["additional_data"] = additional_data
+
+    with path.open("a", encoding="utf-8") as handle:
+        handle.write(json.dumps(payload, ensure_ascii=False) + "\n")
+
+    return payload
+
+
+def summarize_logs(log_path: str | Path | None = None) -> dict[str, Any]:
+    """Return a compact summary of the stored error logs."""
+    path = _ensure_log_path(log_path)
+    if not path.exists():
+        return {
+            "total_errors": 0,
+            "exception_counts": {},
+            "project_counts": {},
+            "latest_errors": [],
+        }
+
+    exception_counts: Counter[str] = Counter()
+    project_counts: Counter[str] = Counter()
+    latest_errors: list[dict[str, Any]] = []
+
+    with path.open("r", encoding="utf-8") as handle:
+        for line in handle:
+            line = line.strip()
+            if not line:
+                continue
+            payload = json.loads(line)
+            exception_counts[payload["exception_type"]] += 1
+            project_counts[payload["project_name"]] += 1
+            latest_errors.append(payload)
+
+    return {
+        "total_errors": sum(exception_counts.values()),
+        "exception_counts": dict(exception_counts),
+        "project_counts": dict(project_counts),
+        "latest_errors": latest_errors[-5:],
+    }
+
+
+def safe_run(project_name: str, action, log_path: str | Path | None = None):
+    """Run an action while logging any unexpected exceptions."""
+    try:
+        return action()
+    except Exception as exc:  # pylint: disable=broad-except
+        log_exception(project_name, exc, log_path=log_path)
+        raise

tests/test_error_logger.py

@@ -0,0 +1,50 @@
+import json
+import os
+import tempfile
+import unittest
+from pathlib import Path
+
+import sys
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+
+from error_logger import log_exception, summarize_logs
+
+
+class ErrorLoggerTests(unittest.TestCase):
+    def test_log_exception_writes_structured_entry(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            log_path = Path(tmpdir) / "error-logs.jsonl"
+            log_exception(
+                project_name="Sample Project",
+                exception=ValueError("broken input"),
+                log_path=log_path,
+            )
+
+            self.assertTrue(log_path.exists())
+            with log_path.open("r", encoding="utf-8") as handle:
+                payload = json.loads(handle.read().strip())
+
+            self.assertEqual(payload["project_name"], "Sample Project")
+            self.assertEqual(payload["exception_type"], "ValueError")
+            self.assertIn("broken input", payload["error_message"])
+            self.assertIn("timestamp", payload)
+            self.assertIn("traceback", payload)
+
+    def test_summarize_logs_counts_by_exception(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            log_path = Path(tmpdir) / "error-logs.jsonl"
+            log_exception("Project A", FileNotFoundError("missing file"), log_path=log_path)
+            log_exception("Project B", FileNotFoundError("missing file"), log_path=log_path)
+            log_exception("Project B", IndexError("bad index"), log_path=log_path)
+
+            summary = summarize_logs(log_path)
+
+            self.assertEqual(summary["total_errors"], 3)
+            self.assertEqual(summary["exception_counts"]["FileNotFoundError"], 2)
+            self.assertEqual(summary["project_counts"]["Project B"], 2)
+            self.assertEqual(summary["project_counts"]["Project A"], 1)
+
+
+if __name__ == "__main__":
+    unittest.main()

utilities/Text-to-Morse/Text-to-Morse.py

@@ -1,4 +1,12 @@
 import sys
+from pathlib import Path
+
+sys.path.append(str(Path(__file__).resolve().parents[2]))
+
+from error_logger import log_exception
+
+print("📻 Morse Code Translator 📻")
+print("Translate text to Morse code and vice versa\n")
 import time
 
 morse_code = {
@@ -25,6 +33,7 @@
 WORD_GAP       = 700   # ms  – silence for word separator '/'
 BEEP_FREQ      = 700   # Hz  – comfortable mid-range tone
 
+def main():
 
 def _sleep_ms(ms: int) -> None:
     """Sleep for *ms* milliseconds."""
@@ -93,6 +102,59 @@ def main():
         print("3️⃣  View Morse Code Chart")
         print("4️⃣  Exit")
         print("=" * 50)
+        
+        choice = input("\n➡️  Enter your choice (1-4): ")
+        
+        if choice == '1':
+            text = input("\n📝 Enter text to convert: ").upper()
+            morse_result = []
+            
+            for char in text:
+                if char in morse_code:
+                    morse_result.append(morse_code[char])
+                elif char == ' ':
+                    morse_result.append('/')
+            
+            morse_output = ' '.join(morse_result)
+            print(f"\n📻 Morse Code: {morse_output}\n")
+        
+        elif choice == '2':
+            morse_input = input("\n📻 Enter Morse code (separate letters with space, words with ' / '): ")
+            morse_chars = morse_input.split(' ')
+            text_result = []
+            
+            for code in morse_chars:
+                if code in reverse_morse:
+                    text_result.append(reverse_morse[code])
+                elif code == '/':
+                    text_result.append(' ')
+                else:
+                    text_result.append('?')
+            
+            text_output = ''.join(text_result)
+            print(f"\n📝 Text: {text_output}\n")
+        
+        elif choice == '3':
+            print("\n📊 Morse Code Chart:\n")
+            print("Letters:")
+            for i, (key, value) in enumerate(list(morse_code.items())[:26], 1):
+                print(f"  {key}: {value:8}", end='')
+                if i % 4 == 0:
+                    print()
+            
+            print("\n\nNumbers:")
+            for key, value in list(morse_code.items())[26:36]:
+                print(f"  {key}: {value}")
+            
+            print("\nSpecial Characters:")
+            for key, value in list(morse_code.items())[36:]:
+                print(f"  {key}: {value}")
+            print()
+        
+        elif choice == '4':
+            print("\n👋 Thanks for using Morse Code Translator! Goodbye!\n")
+            break
+        
 
         choice = input("\n➡️  Enter your choice (1-4): ")
 
@@ -196,4 +258,9 @@ def main():
 
 
 if __name__ == "__main__":
+    try:
+        main()
+    except Exception as exc:
+        log_exception("Text-to-Morse", exc)
+        raise
     main()