roadsync_slogger 1.0.4

A python logger similar to Go's slogger

SLogger

SLogger is a structured logger inspired by Go's slog, designed to simplify logging with key-value pairs in Python. It supports both plain text and JSON formats, with context fields being logged as top-level keys such as username and request_id.

Installation

Install SLogger via pip:

pip install roadsync_slogger

Basic Usage

SLogger logs messages along with additional context in a flat structure. Here's an example using the JSON format:

JSON Logging Example

import logging
from roadsync_slogger import SLogger

# Set up base logger
base_logger = logging.getLogger("example")
base_logger.setLevel(logging.DEBUG)

# Create SLogger instance with JSON format
logger = SLogger(base_logger, format="json")

# Add initial context with username
logger = logger.with_fields(username="johndoe")

# Log a message with initial context
logger.info("User initialized session", request_id="abc123")
# Log output:
# {
#   "message": "User initialized session",
#   "username": "johndoe",
#   "request_id": "abc123"
# }

Using .with_fields()

The .with_fields() method allows you to persist fields across multiple log calls. Each call to .with_fields() returns a new SLogger instance with the added fields, leaving the original context unchanged.

Example:

# Adding fields using .with_fields()
logger = logger.with_fields(username="johndoe", request_id="abc123")

# Logging with the updated context
logger.info("Performed a profile update", action="update_profile")
# Log output:
# {
#   "message": "Performed a profile update",
#   "username": "johndoe",
#   "request_id": "abc123",
#   "action": "update_profile"
# }

Adding Context

You can continue adding fields with subsequent calls to .with_fields(), merging new context with existing fields. This allows for flexibility when extending the log context.

Example with Added Context:

# Initial logger with username field
logger = logger.with_fields(username="johndoe")

# Adding more context with action and request_id
logger = logger.with_fields(action="login", request_id="def456")
logger.info("Login successful")
# Log output:
# {
#   "message": "Login successful",
#   "username": "johndoe",
#   "request_id": "def456",
#   "action": "login"
# }