BitSig 0.1.1

A modern way to auto log system errors

---

Features

• Deduplicated Logging: Prevents duplicate log entries within each log file, keeping your logs concise and clean.
• Per-Level Log Files: Saves log entries to separate files by level (Debug.txt, Info.txt, Warning.txt, Error.txt, Critical.txt) for easy tracking and analysis.
• Automatic Log Cleanup: Periodically purges log entries older than your retention window (default: 24 hours), with full customization.
• Thread-Safe: All logging and cleanup operations are safe for multi-threaded environments.
• Console Output: Only errors and critical logs are printed to the console by default, with consistent formatting.
• Flexible Integration: Just call configureBitSig(logsDir) and start logging—no need to rewrite your codebase.

---

Installation

pip install BitSig

---

Quick Start

from logmanager import configureBitSig
from pathlib import Path
import logging

# Initialize BitSig (set your desired logs directory)
logsDir = Path("logs")
configureBitSig(logsDir)

# Use standard logging
logger = logging.getLogger(__name__)
logger.info("This is an info message.")
logger.error("This is an error message.")

---

How It Works

• Deduplication: BitSig compares each new log entry (except the timestamp/level prefix) to recent entries in its level’s file and writes only unique messages.
• Cleanup: Log files are automatically cleaned in the background, keeping only entries within your retention window (default: 24 hours, configurable with LOG_RETENTION_HOURS in your .env or environment).
• Retention: Customize how long logs are kept by setting the LOG_RETENTION_HOURS environment variable.

---

Configuration

• Log Directory: Pass any Path to configureBitSig(). Directory will be created if missing.

• Log Retention: Set the number of hours to keep log entries:

  LOG_RETENTION_HOURS=48
  

  (in your .env or system environment)

• Threaded Cleanup: BitSig launches a daemon thread to clean logs every hour. No user intervention needed.

---

Advanced Usage

• Custom Filters: BitSig supports adding more custom logging.Filter instances if needed.
• Multiple Loggers: All loggers in your app will use the same log directory and handlers by default.

---

Example

from logmanager import configureBitSig
import logging

configureBitSig("my_logs")

logger = logging.getLogger("MyApp")
logger.info("Started application.")
logger.error("An error occurred.")

---

Notes

• BitSig is compatible with Python 3.8+ and all standard logging calls.
• Log file deduplication works at the message-body level for maximum efficiency.
• BitSig is optimized for long-running, high-traffic, or mission-critical systems.

---

License

This project is licensed under the Apache License, Version 2.0. Copyright 2025 Tristan McBride Sr.

---

Acknowledgements

Project by:

• Tristan McBride Sr.
• Sybil