darca-log-facility 0.1.0

Features

• Configurable logging levels (DEBUG, INFO, WARNING, ERROR, CRITICAL).

• File & Console Logging (with log rotation to prevent excessive file sizes).

• JSON Logging Format (for structured logs, useful for log processors).

• Colored Console Output (using colorlog for improved readability).

• Thread-safe Logging (safe for multi-threaded applications).

• Dynamically Change Log Level (without restarting the application).

Installation

To install Darca Log Facility, first, clone the repository:

git clone https://github.com/roelkist/darca-log-facility.git
cd darca-log-facility

Then install dependencies using Poetry:

poetry install --with dev,docs

Makefile Usage

This project includes a Makefile to simplify common tasks.

• Format code:

  make format

• Run linting checks:

  make lint

• Run tests:

  make test

• Run pre-commit hooks:

  make precommit

• Generate documentation:

  make docs

• Run all pre-push checks (format, lint, test, precommit):

  make check

• Run full CI pipeline (precommit, lint, test):

  make ci

Usage

Basic usage example:

from darca_log_facility.logger import DarcaLogger
import logging

# Initialize logger
logger = DarcaLogger(name="my_app", level=logging.INFO).get_logger()

# Log messages
logger.debug("This is a debug message")
logger.info("This is an info message")
logger.warning("This is a warning message")
logger.error("This is an error message")
logger.critical("This is a critical message")

File logging example:

logger = DarcaLogger(name="file_logger", log_directory="logs", log_to_file=True).get_logger()
logger.info("This message will be written to a log file.")

JSON logging example:

logger = DarcaLogger(name="json_logger", log_directory="logs", json_format=True).get_logger()
logger.info("This log is formatted as JSON.")

Configuration Options

DarcaLogger supports multiple configuration options:

Development and Contribution

We welcome contributions! Follow these steps to contribute:

1. Fork the repository: https://github.com/roelkist/darca-log-facility

2. Clone your forked repo:

   git clone https://github.com/YOUR_USERNAME/darca-log-facility.git

3. Install dependencies using Poetry:

   poetry install --with dev,docs

4. Run all checks before submitting code:

   make check

5. Submit a pull request.

Testing

Darca Log Facility uses pytest for testing. To run the test suite, use:

make test

make ci

License

This project is licensed under the MIT License.

Contact

• GitHub Repository: https://github.com/roelkist/darca-log-facility

• Issues & Bug Reports: https://github.com/roelkist/darca-log-facility/issues

Enjoy using Darca Log Facility! 🚀