FlexiLogger 1.0.4

A customizable logger and traceback handler for Python applications

FlexiLogger

FlexiLogger is a customizable Python logging library that provides enhanced features for handling logs, including colorized console outputs, log file formatting, and detailed traceback management.

Features

• Colorized console logging for better readability.
• File-based logging with customizable formats.
• Dynamic configuration via environment variables.
• Enhanced traceback extraction and logging.
• Customizable log level spaces for better alignment.

---

Installation

You can install FlexiLogger using pip:

pip install FlexiLogger

---

Usage

Basic Usage

To use FlexiLogger in your project:

from FlexiLogger import Logger

logger = Logger(__file__, log_file_path="app.log")
logger.info("This is an info message")
logger.error("This is an error message")

Advanced Traceback Handling

FlexiLogger provides a GetTraceback class for managing exceptions:

import os

os.environ['LOG_PATH'] = 'app.log'  # noqa
from FlexiLogger import Logger, GetTraceback

logger = Logger(__file__, log_file_open_format='w')
traceback_handler = GetTraceback(logger)

try:
    1 / 0
except Exception as e:
    traceback_handler.error("An error occurred", print_full_exception=True)

---

Environment Variables

FlexiLogger uses several environment variables to customize its behavior:

Variable Name	Description	Default Value
LOG_PATH	Specifies the path to the log file. If not set, logging to a file is disabled.	None
LOG_TRACEBACK_PATH	Specifies the path where traceback will be saved. If not set, the file defined in the Logger will be used.	None
LOGGER_CONSOLE_LOG_LEVEL	Sets the console log level. Acceptable values: DEBUG, INFO, WARNING, ERROR, CRITICAL.	DEBUG
LOGGER_FILE_LOG_LEVEL	Sets the file log level. Acceptable values: DEBUG, INFO, WARNING, ERROR, CRITICAL.	DEBUG
LOGGER_TIME_INFO	Enables or disables timestamps in log messages. Values: true/1 or false/0.	true

Example

Set the environment variables before running your script:

export LOG_PATH="app.log"
export LOGGER_CONSOLE_LOG_LEVEL="INFO"
export LOGGER_FILE_LOG_LEVEL="ERROR"
export LOGGER_TIME_INFO="false"

---

Project Structure

FlexiLogger/
├── src/
│   └── FlexiLogger/
│       ├── __init__.py
│       ├── gettraceback.py
│       ├── logger.py
│       └── py.typed
├── .pre-commit-config.yaml
├── CONTRIBUTING.md
├── LICENSE
├── pyproject.toml
└── README.md

---

License

FlexiLogger is licensed under the MIT License. See the LICENSE file for details.

---

Contributions

Contributions are welcome! Please read our Contributing Guide to learn how to set up your environment and submit your changes.