litewave-logger 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: litewave_logger
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: A lightweight logging library with context carry forward
5
5
  Author: Litewave
6
6
  Author-email: Sonu Sudhakaran <sonu@litewave.ai>
@@ -1,5 +1,5 @@
1
1
  import logging
2
- import uuid
2
+ import json
3
3
  from contextvars import ContextVar
4
4
 
5
5
  # Context variable to hold the request ID
@@ -17,11 +17,28 @@ class RequestIdFilter(logging.Filter):
17
17
  record.request_id = request_id_var.get()
18
18
  return True
19
19
 
20
+ class JsonLogFormatter(logging.Formatter):
21
+ """
22
+ Formatter that outputs logs as JSON with required fields.
23
+ """
24
+ def format(self, record):
25
+ # Collect fields with fallback to None for path, method, and status_code
26
+ log_object = {
27
+ "timestamp": self.formatTime(record, self.datefmt),
28
+ "level": record.levelname,
29
+ "request_id": getattr(record, "request_id", None),
30
+ "path": getattr(record, "path", None),
31
+ "method": getattr(record, "method", None),
32
+ "message": record.getMessage(),
33
+ "status_code": getattr(record, "status_code", None),
34
+ "error": getattr(record, "error", None),
35
+ }
36
+ return json.dumps(log_object)
20
37
 
21
38
  def setup_logging():
22
39
  """
23
40
  Configures the logging for the application.
24
- It sets up a handler, a formatter, and adds the RequestIdFilter.
41
+ Uses a JSON formatter and adds the RequestIdFilter.
25
42
  """
26
43
  logger = logging.getLogger()
27
44
  logger.setLevel(logging.INFO)
@@ -29,9 +46,7 @@ def setup_logging():
29
46
  # Prevent adding duplicate handlers
30
47
  if not logger.handlers:
31
48
  handler = logging.StreamHandler()
32
- formatter = logging.Formatter(
33
- "%(asctime)s - %(name)s - %(levelname)s - [%(request_id)s] - %(message)s"
34
- )
49
+ formatter = JsonLogFormatter()
35
50
  handler.setFormatter(formatter)
36
51
  logger.addHandler(handler)
37
52
 
@@ -0,0 +1,59 @@
1
+ import uuid
2
+ import time
3
+ import logging
4
+ from datetime import datetime
5
+ from starlette.middleware.base import BaseHTTPMiddleware
6
+ from starlette.requests import Request
7
+
8
+ from . import request_id_var
9
+
10
+ logger = logging.getLogger(__name__)
11
+ RequestIdHeader = "X-Request-ID"
12
+ # This middleware is used to handle the request ID and provide comprehensive debugging.
13
+ # It checks for a 'X-Request-ID' header in the incoming request.
14
+ # If the header is present, its value is used as the request ID.
15
+ # If not, a new UUID is generated.
16
+ # The request ID is then stored in a context variable.
17
+ class RequestIdMiddleware(BaseHTTPMiddleware):
18
+ """
19
+ FastAPI middleware to handle the request ID and provide comprehensive debugging.
20
+ It checks for a 'X-Request-ID' header in the incoming request.
21
+ If the header is present, its value is used as the request ID.
22
+ If not, a new UUID is generated.
23
+ The request ID is then stored in a context variable.
24
+ Provides detailed logging for incoming requests and outgoing responses.
25
+ """
26
+ async def dispatch(self, request: Request, call_next):
27
+ # Extract request information
28
+ method = request.method
29
+ path = request.url.path
30
+ # Get or generate request ID
31
+ request_id = request.headers.get(RequestIdHeader)
32
+ if not request_id:
33
+ request_id = str(uuid.uuid4())
34
+
35
+ # Set request ID in context
36
+ request_id_var.set(request_id)
37
+
38
+ logger.info("request received", extra={"method": method, "path": path})
39
+
40
+ try:
41
+ # Process the request
42
+ response = await call_next(request)
43
+
44
+ # Add request ID to response headers
45
+ response.headers[RequestIdHeader] = request_id
46
+
47
+ # Log response details
48
+ logger.info("response sent", extra={"status_code": response.status_code})
49
+
50
+ return response
51
+
52
+ except Exception as e:
53
+ # Log error details
54
+ logger.error("request failed", extra={"method": method, "path": path, "error": str(e)})
55
+
56
+ # Re-raise the exception
57
+ raise
58
+
59
+ __all__ = ["RequestIdMiddleware"]
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: litewave_logger
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: A lightweight logging library with context carry forward
5
5
  Author: Litewave
6
6
  Author-email: Sonu Sudhakaran <sonu@litewave.ai>
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "litewave_logger"
3
- version = "0.1.0"
3
+ version = "0.2.0"
4
4
  description = "A lightweight logging library with context carry forward"
5
5
  authors = [{name = "Sonu Sudhakaran", email = "sonu@litewave.ai"}]
6
6
  dependencies = [
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
2
2
 
3
3
  setup(
4
4
  name="litewave_logger",
5
- version="0.1.0",
5
+ version="0.2.0",
6
6
  description="A centralized logging module for Litewave services.",
7
7
  author="Litewave",
8
8
  packages=find_packages(),
@@ -1,31 +0,0 @@
1
- import uuid
2
- from starlette.middleware.base import BaseHTTPMiddleware
3
- from starlette.requests import Request
4
-
5
- from . import request_id_var
6
-
7
- # This middleware is used to handle the request ID.
8
- # It checks for a 'X-Request-ID' header in the incoming request.
9
- # If the header is present, its value is used as the request ID.
10
- # If not, a new UUID is generated.
11
- # The request ID is then stored in a context variable.
12
- class RequestIdMiddleware(BaseHTTPMiddleware):
13
- """
14
- FastAPI middleware to handle the request ID.
15
- It checks for a 'X-Request-ID' header in the incoming request.
16
- If the header is present, its value is used as the request ID.
17
- If not, a new UUID is generated.
18
- The request ID is then stored in a context variable.
19
- """
20
- async def dispatch(self, request: Request, call_next):
21
- request_id = request.headers.get("X-Request-ID")
22
- if not request_id:
23
- request_id = str(uuid.uuid4())
24
-
25
- request_id_var.set(request_id)
26
-
27
- response = await call_next(request)
28
- response.headers["X-Request-ID"] = request_id_var.get()
29
- return response
30
-
31
- __all__ = ["RequestIdMiddleware"]