Merge pull request #19 from DogukanUrker/Add-key-value-logging-to-all-log-methods

Add key-value logging to all log methods - remove `dir()`

Author: DogukanUrker

Images/terminal.png

@@ -19,7 +19,7 @@ A modern, high-performance logging utility for Python with multiple output forma
 - 🔄 **Automatic Rotation** - File size management with backup support
 - 🧵 **Thread-Safe** - Safe for multi-threaded applications
 - 🔔 **Notifications** - Multi-service notifications via [Apprise](https://github.com/caronc/apprise) (Discord, Slack, Email, SMS, and more)
-- 🔍 **Structured Logging** - Key-value data support with `dir()` method
+- 🔍 **Structured Logging** - Key-value data support with all log methods
 
 ## 🚀 Quick Start
 
@@ -77,13 +77,28 @@ logger = Tamga(
 
 ### Structured Logging
 ```python
-# Log with key-value data
-logger.dir("User action",
+# Log with key-value data using any log method
+logger.info("User action",
     user_id="123",
     action="login",
     ip_address="192.168.1.1",
     success=True
 )
+
+# Works with all log levels
+logger.error("Database connection failed",
+    host="localhost",
+    port=5432,
+    timeout=30,
+    retry_count=3
+)
+
+logger.success("Payment processed",
+    amount=99.99,
+    currency="USD",
+    method="credit_card",
+    transaction_id="tx_123"
+)
 ```
 
 ### Production Setup
@@ -127,7 +142,6 @@ logger = Tamga(
 | NOTIFY | Purple | `logger.notify()` | Send notifications |
 | METRIC | Cyan | `logger.metric()` | Performance metrics |
 | TRACE | Gray | `logger.trace()` | Detailed trace info |
-| DIR | Yellow | `logger.dir()` | Structured key-value data |
 | CUSTOM | Any | `logger.custom()` | Custom levels |
 
 ## 🔧 Advanced Features

README.md

@@ -54,7 +54,7 @@
 logger.notify("New premium subscription purchased!")
 
 # Structured logging for business events
-logger.dir(
+logger.success(
     "User action",
     user_id="user_456",
     action="purchase",

examples/advanced_config.py

@@ -18,14 +18,14 @@
 
 @app.middleware("http")
 async def log_requests(request: Request, call_next):
-    logger.dir(
+    logger.info(
         "Incoming request",
         method=request.method,
         path=request.url.path,
         client=str(request.client.host),
     )
     response = await call_next(request)
-    logger.dir(
+    logger.info(
         "Request completed",
         method=request.method,
         path=request.url.path,

examples/fastapi_webapp.py

@@ -20,7 +20,7 @@
 logger.debug("Debugging variable x=42")
 
 # Structured logging with key-value pairs
-logger.dir(
+logger.info(
     "User login event",
     user_id="abc123",
     action="login",

examples/simple_usage.py

@@ -224,13 +224,19 @@ logger.warning("High memory usage")  # WARNING not in notify_levels
 # Custom level and color
 logger.custom("Deploy completed", "DEPLOY", "purple")
 
-# Structured logging with key-value data
-logger.dir("User action",
+# Structured logging with key-value data using any log method
+logger.info("User action",
     user_id="123",
     action="login",
     ip_address="192.168.1.1",
     success=True
 )
+
+# Works with all log levels
+logger.error("Database connection failed", host="localhost", port=5432, timeout=30)
+logger.success("Payment processed", amount=99.99, currency="USD", method="credit_card")
+logger.warning("High memory usage", memory_pct=85, threshold=80)
+logger.critical("System overload", cpu_pct=95, memory_pct=98)
 ```
 
 ### Advanced Notification Usage
@@ -381,7 +387,7 @@ def log_request(request):
     start_time = time.time()
 
     # Log request details
-    logger.dir("Request started",
+    logger.info("Request started",
         request_id=request_id,
         method=request.method,
         path=request.path,
@@ -392,7 +398,7 @@ def log_request(request):
         response = process(request)
         duration = time.time() - start_time
 
-        logger.dir("Request completed",
+        logger.info("Request completed",
             request_id=request_id,
             status=response.status_code,
             duration_ms=round(duration * 1000)
@@ -422,7 +428,7 @@ logger = Tamga(
 
 # Add service context to all logs
 def log_with_context(message, level="info"):
-    logger.dir(message,
+    logger.info(message,
         service=service_name,
         version=os.getenv("VERSION"),
         instance=os.getenv("INSTANCE_ID")
@@ -575,7 +581,7 @@ logger = Tamga(
 
 # Application usage
 logger.info("Application starting")
-logger.dir("Configuration loaded",
+logger.info("Configuration loaded",
     environment=os.getenv("ENV"),
     debug_mode=True
 )

llms.txt

@@ -1,6 +1,6 @@
 [project]
 name = "tamga"
-version = "1.3.1"
+version = "1.4.0"
 authors = [{ name = "Doğukan Ürker", email = "dogukanurker@icloud.com" }]
 description = "A modern, high-performance async logging utility with multiple output formats and colorful console output"
 readme = "README.md"

pyproject.toml

@@ -15,13 +15,8 @@
 logger.error("💥 Payment failed: Card declined")
 logger.critical("🚨 Data breach detected! Initiating lockdown")
 logger.debug("🔍 Feature flag 'beta_mode' is ON")
-logger.custom("🛒 Checkout event: Cart abandoned", "METRIC", "cyan")
+logger.metric("🛒 Checkout event: Cart abandoned")
 logger.custom("🎨 Theme switched to 'dark mode'", "UI", "purple")
-logger.dir(
-    "🔑 User login",
-    user_id="42",
-    verified=True,
-)
-logger.info("🌈 All systems go. Have an epic day!")
+logger.info("🔑 User login", user_id="42", verified=True)
 
 print("\n")

scripts/screenshot.py

@@ -4,7 +4,7 @@
 
 from .main import Tamga
 
-__version__ = "1.3.1"
+__version__ = "1.4.0"
 __author__ = "Doğukan Ürker"
 __email__ = "dogukanurker@icloud.com"
 __license__ = "MIT"

tamga/__init__.py

@@ -41,7 +41,6 @@
     "NOTIFY": "purple",
     "METRIC": "cyan",
     "TRACE": "gray",
-    "DIR": "yellow",
 }
 
 LOG_EMOJIS: Dict[str, str] = {
@@ -55,5 +54,4 @@
     "NOTIFY": "📢",
     "METRIC": "📊",
     "TRACE": "🔍",
-    "DIR": "📝",
 }