Lupin Logger

A custom logging system for LupinDental with colored console output and structured JSON logging.

Features

• Colored console output with visual formatting based on log level
• Structured JSON logs saved to .lupinlogs.jsonl files
• Custom attributes with automatic type-based coloring
• Custom NOTICE level (between INFO and WARNING)
• Automatic organization of logs by date
• Full traceability with timestamp, application, origin, and location

Installation from PYPI

pip install lupin_logger

Deployment on PYPI

• Add the version to pyproject.toml

version = "0.1.0"

• Go to GitLab Tags

  • Click on New tag
  • Select the main branch if it is a final tag and click on Create tag.
  • Select the current branch if it is a test or development tag.

Quick Start

from lupin_logger import get_logger

# Create a logger
logger = get_logger(name="my_module", app="my_application")

# Basic logs
logger.info("Application started")
logger.debug("Debug information")
logger.warning("Warning!")
logger.error("An error occurred")
logger.critical("Critical error")

# Custom NOTICE level
logger.notice("Important operation succeeded")

Logging with Attributes

Attributes allow you to add structured data to your logs:

# Simple attributes
logger.info("File processed", {"filename": "data.csv", "rows": 1500})

# With different types (automatic coloring)
logger.info("Process completed", {
    "duration": 3.14,        # float → yellow
    "success": True,          # bool → white
    "files_count": 42,        # int → yellow
    "output_path": Path("/tmp/out")  # Path → cyan
})

# Exception logging
try:
    result = 1 / 0
except Exception:
    logger.exception("Division by zero", {"operation": "calculate"})

Log Levels

Log Directory Configuration

By default, logs are saved to:

• Linux/macOS: ~/LupinDentalData/logs/
• Windows: C:/Users/<USERNAME>/LupinDentalData/logs/

Custom Directory

logger = get_logger(
    name="my_module",
    app="my_app",
    log_directory="/custom/path/logs"
)

Development

Requirements

• Python >= 3.11

Development Installation

git clone https://gitlab.com/lupindental/arsene/rd-utilities/lupin_logger.git
cd lupin_logger
pip install -e .

License

MIT - LupinDental