Tamga - Modern Python Logging Utility

Powerful Features

🎨

Colorful Output

Beautiful console logs with Tailwind CSS color palette for enhanced readability.

⚡

Async Support

Working on it. 🚧

📁

Multiple Formats

Support for File, JSON, SQLite, and MongoDB logging out of the box.

📧

Email Alerts

Automated email notifications for critical events and custom log levels.

🔄

Auto Rotation

Automatic file rotation and backup when size limits are reached.

🌐

API Integration

Send logs to remote endpoints with built-in API support.

Quick Start & Examples

# Install Tamga
pip install tamga

# Initialize logger
from tamga import Tamga

logger = Tamga(
    logToFile=True,
    logToJSON=True,
    logToConsole=True
)

# Available log levels with different colors
logger.info("Connected to database")          # Sky blue
logger.warning("High memory usage")           # Amber
logger.error("Connection failed")             # Rose
logger.success("Task completed")              # Emerald
logger.debug("Processing request")            # Indigo
logger.critical("System overload")            # Red

# Custom logging with your own color
logger.custom("Custom event", "EVENT", "orange")

# MongoDB Integration
from tamga import Tamga

logger = Tamga(
    logToMongo=True,
    mongoURI="your_mongodb_uri",
    mongoDatabaseName="logs_db",
    mongoCollectionName="application_logs"
)

# Logs will be automatically stored in MongoDB
logger.info("User logged in")
logger.error("Database connection failed")

# Email Notification Setup
from tamga import Tamga

logger = Tamga(
    sendMail=True,
    smtpServer="smtp.gmail.com",
    smtpPort=587,
    smtpMail="your_email@gmail.com",
    smtpPassword="your_password",
    smtpReceivers=["receiver@email.com"],
    mailLevels=["CRITICAL", "ERROR"]
)

# These logs will trigger email notifications
logger.critical("Server down!")
logger.error("Security breach detected")

# File Rotation and Backup Configuration
from tamga import Tamga

logger = Tamga(
    logToFile=True,
    logToJSON=True,
    maxLogSize=10,      # Max size in MB
    maxJsonSize=10,     # Max size in MB
    enableBackup=True   # Auto backup when size limit reached
)

# Logs will be automatically rotated and backed up
logger.info("Application started")
logger.metric("CPU Usage: 75%")

# API Integration for Remote Logging
from tamga import Tamga

logger = Tamga(
    logToAPI=True,
    apiURL="http://your-api.com/logs"
)

# Logs will be sent to your API endpoint
logger.trace("User action tracked")
logger.database("Query executed: SELECT * FROM users")